# 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>”)