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 函数/运算符
- 引入模板 不指定后缀就寻找 layout.ejs. (注意:如果没有定义模板目录,则 include无效)
<% include layout.html%> <%- include layout.html%>
- 静态编译模板,没有 IO 操作,会非常快,而且可以公用本地变量.
-
<% users.forEach(function(user){ %>
<% include user/show %>
<% }) %>
- 自定义 闭合标签. 厌倦了 <% %> ?
//设置闭合标签
var ejs = require('ejs');
ejs.open = '{{';
ejs.close = '}}';
express中全局设定
app.set("view options",{
"open":"{{",
"close":"}}"
});
- 变量
//传递 index 模板引擎参数
res.render('index',{'title':'haha');
//使用参数
<title><%= title %></title>
- 运行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%>>
- 给模板添加方法
app.locals[‘say’] = function(){ return 'hello’; }; 在 app.locals 中定义的方法都可以在模板中引用 <input type="button" value=<%=say()%>>