# higanbana 模板引擎
higanbana(彼岸花)express模板引擎
使用nodejs开发已久,期间使用了很多模板引擎,不过都不好用,心想,要是有一种模板引擎能够像angularJS或vue那样在标签上加上一些属性就能渲染该多好,所以呢,自己动手写一个吧!!!
[English Document](./README.md)
## 安装
```
npm install --save higanbana
```
然后,你需要在express中配置higanbana模板引擎,具体的配制方法见express官网。
```js
app.engine('html', require('higanbana')()) //文件后缀可以是其他
```
## 使用 - 变量输出
使用 {{ $变量 }} 即可输出变量,如:
```html
{{user.name.first}} {{user.name.last}}
```
大括号中还支持一些js运算,如
```html
{{num1}} + {{num2}} = {{num1 + num2}}
```
## 使用 - 条件判断
在HTML标签上加上 hi-if、hi-else、hi-show、hi-hide 属性可以控制该标签是否渲染,不过这里更推荐用hi-show和hi-hide,如:
```html
a大于0
a大于0
a等于0
a小于0
a等于40
a不等于40
```
## 使用 - 循环输出
在HTML标签上加上 hi-for 属性即可循环输出,可以用于数组和对象的输出,有两种循环方式(带索引和不带索引),如果循环对象是一个数字,则表示一个0到该数字的区间,参考例子:
```html
| {{user.id}} |
{{user.name}} |
| {{index+1}} |
{{user.id}} |
{{user.name}} |
{{item}}
{{key}}:{{item}}
| {{index+1}} |
{{user.id}} |
{{user.name}} |
{{ num1 }}
{{ (num2>=0) ? '+' : '-' }}
{{ Math.abs(num2) }}
=
{{ num1+num2 }}
{{ch}}
```
## 使用 - 区间操作
使用mkrange(from:number, to?:number):Array
函数可以创建一个左闭右开区间,如:
```js
mkrange(1, 3) // 1, 2
mkrange(3) // 0, 1, 2
mkrange(3, 0) // 3, 2, 1
```
具体写法如:
```html
{{number}}
```
## 使用 - 模板中创建值
使用val(v:any):any函数可以创建一个值,以方便在系统标签中使用该值,不过这种用法不是很常见,下面是一个例子:
```html
{{N+1}}:{{ch}}
```
## 使用 - 导入其他模板文件
使用require标签进行导入,require标签中path表示模板文件的相对路径,例如:
```html
```
## 特别注意
* 一个标签中只能出现一个判断标签(hi-if、hi-else、hi-show、hi-hide 之一)
* 如果在一个标签上同时又 hi-for 和 hi-if系列 属性,则会优先进行 hi-for
* require标签必须有闭合标签(可以是“<require path="..." />”,也可以是“<require path="..."></require>”)