Node.js 手册查询-5-Ejs 方法

ejs 手册

标签（空格分隔）： ejs

---

express 中使用

//设置模板目录
app.set('views', path.join(__dirname, 'views'));    

//设置模板引擎
app.set('view engine', 'html');

//设置引擎后缀.  index.html 中的内容可以是 ejs 代码
app.engine('.html', require('ejs').__express);

ejs的特性：

1、缓存功能，能够缓存已经解析好的html模版；

2、<% code %>用于执行其中javascript代码；

3、<%= code %>会对code进行html转义；

4、<%- code %>将不会进行转义；

5、支持自定义标签，比如’<%‘可以使用’{{’，’%>‘用’}}'代替；

6、提供一些辅助函数，用于模版中使用

7、利用<%- include filename %>加载其他页面模版；

ejs 函数/运算符

1. 引入模板 不指定后缀就寻找 layout.ejs. (注意:如果没有定义模板目录,则 include无效)

<% include layout.html%> <%- include layout.html%>

1. 静态编译模板,没有 IO 操作，会非常快，而且可以公用本地变量.

<% users.forEach(function(user){ %> <% include user/show %> <% }) %>

意思就是模板名是动态的

1. 自定义 闭合标签. 厌倦了 <% %> ?

//设置闭合标签
var ejs = require('ejs');  
ejs.open = '{{';  
ejs.close = '}}';

express中全局设定

app.set("view options",{                                                                                  
   "open":"{{",                                                                                  
   "close":"}}"
});

1. 变量

//传递 index 模板引擎参数
res.render('index',{'title':'haha');

//使用参数
<title><%= title %></title>

1. 运行js代码

<%for(var i=p.length-1; i>=0; i--){%>
<input type="button" value=<%=p[i]%>>
<%}%>

选项 express中 通过 res.redirect(‘login’, [options]); 来对模板进行访问,options就可以设置模板引擎的一些选项 其中options的一些参数为：

1、cache：是否缓存解析后的模版，需要filename作为key；

2、filename：模版文件名；

3、scope：complile后的Function执行所在的上下文环境；

4、debug：标识是否是debeg状态，debug为true则会输出生成的Function内容；

5、compileDebug：标识是否是编译debug，为true则会生成解析过程中的跟踪信息，用于调试；

6、client，标识是否用于浏览器客户端运行，为true则返回解析后的可以单独运行的Function函数；

7、open，代码开头标记，默认为’<%’；

8、close，代码结束标记，默认为’%>’；

9、其他的一些用于解析模版时提供的变量。

在express中使用时，options参数将由response.render进行传入，其中包含了一些express中的设置，以及用户提供的变量值。

f辅助函数 此外ejs还提供了一些辅助函数，用于代替使用javascript代码，使得更加方便的操纵数据。

1、first，返回数组的第一个元素；

2、last，返回数组的最后一个元素；

3、capitalize，返回首字母大写的字符串；

4、downcase，返回字符串的小写；

5、upcase，返回字符串的大写；

6、sort，排序（Object.create(obj).sort()？）；

7、sort_by:‘prop’，按照指定的prop属性进行升序排序；

8、size，返回长度，即length属性，不一定非是数组才行；

9、plus:n，加上n，将转化为Number进行运算；

10、minus:n，减去n，将转化为Number进行运算；

11、times:n，乘以n，将转化为Number进行运算；

12、divided_by:n，除以n，将转化为Number进行运算；

13、join:‘val’，将数组用’val’最为分隔符，进行合并成一个字符串；

14、truncate:n，截取前n个字符，超过长度时，将返回一个副本

15、truncate_words:n，取得字符串中的前n个word，word以空格进行分割；

16、replace:pattern,substitution，字符串替换，substitution不提供将删除匹配的子串；

17、prepend:val，如果操作数为数组，则进行合并；为字符串则添加val在前面；

18、append:val，如果操作数为数组，则进行合并；为字符串则添加val在后面；

19、map:‘prop’，返回对象数组中属性为prop的值组成的数组；

20、reverse，翻转数组或字符串；

21、get:‘prop’，取得属性为’prop’的值；

22、json，转化为json格式字符串

辅助函数使用

//注意闭合标签  <%=:  %>
<input type="button" value=<%=:p|first%>>

1. 给模板添加方法

app.locals[‘say’] = function(){ return ‘hello’; }; 在 app.locals 中定义的方法都可以在模板中引用 <input type=“button” value=<%=say()%>>