EJS 模板快速入门

 

EJS 模板快速入门

  6661人阅读  评论(14)  收藏  举报

目录(?)[+]

Node 开源模板的选择很多,但推荐像我这样的老人去用 EJS,有 Classic ASP/PHP/JSP 的经验用起 EJS 来的确可以很自然,也就是说,你能够在 <%...%> 块中安排 JavaScript 代码,利用最传统的方式 <%=输出变量%>(另外 <%-输出变量是不会对 & 等符号进行转义的)。安装 EJS 命令如下:

npm install ejs

JS 调用

JS 调用的方法主要有两个:

[javascript]  view plain copy
  1. <code>ejs.compile(str, options);  
  2. // => Function  
  3.   
  4. ejs.render(str, options);  
  5. // => str</code>  

实际上 EJS 可以游离于 Express 独立使用的,例如:

[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. var ejs = require(''), str = require('fs').readFileSync(__dirname + '/list.ejs''utf8');  
  2.   
  3. var ret = ejs.render(str, {  
  4.   names: ['foo''bar''baz']  
  5. });  
  6.   
  7. console.log(ret);  
见 ejs.render(),第一个参数是 模板 的字符串,模板如下。
[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <% if (names.length) { %>  
  2.   <ul>  
  3.     <% names.forEach(function(name){ %>  
  4.       <li foo='<%= name + "'" %>'><%= name %></li>  
  5.     <% }) %>  
  6.   </ul>  
  7. <% } %>  

names 成了本地变量。

选项参数

第二个参数是数据,一般是一个对象。而这个对象又可以视作为选项,也就是说数据和选择都在同一个对象身上。

如果不想每次都都磁盘,可需要缓存模板,设定 options.filename  即可。例如:

[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. var ejs = require('../')  
  2.   , fs = require('fs')  
  3.   , path = __dirname + '/functions.ejs'  
  4.   , str = fs.readFileSync(path, 'utf8');  
  5.   
  6. var users = [];  
  7.   
  8. users.push({ name: 'Tobi', age: 2, species: 'ferret' })  
  9. users.push({ name: 'Loki', age: 2, species: 'ferret' })  
  10. users.push({ name: 'Jane', age: 6, species: 'ferret' })  
  11.   
  12. var ret = ejs.render(str, {  
  13.   users: users,  
  14.   filename: path  
  15. });  
  16.   
  17. console.log(ret);  

相关选项如下:

  • cache Compiled functions are cached, requires filename
  • filename 缓存的键名称
  • scope 函数执行的作用域
  • debug Output generated function body
  • compileDebug When false no debug instrumentation is compiled
  • client Returns standalone compiled function

inculde 指令

而且,如果要如

<ul>
  <% users.forEach(function(user){ %>
    <% include user/show %>
  <% }) %>
</ul>
般插入公共模板,也就是引入文件,必须要设置 filename 选项才能启动 include 特性,不然 include 无从知晓所在目录。

模板:

[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <h1>Users</h1>  
  2.   
  3. <% function user(user) { %>  
  4.   <li><strong><%= user.name %></strong> is a <%= user.age %> year old <%= user.species %>.</li>  
  5. <% } %>  
  6.   
  7. <ul>  
  8.   <% users.map(user) %>  
  9. </ul>  
EJS 支持编译模板。经过模板编译后就没有 IO 操作,会非常快,而且可以公用本地变量。下面例子 user/show 忽略 ejs 扩展名:
[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <ul>  
  2.   <% users.forEach(function(user){ %>  
  3.     <% include user/show %>  
  4.   <% }) %>  
  5. </ul>  

自定义 CLOSE TOKEN

如果打算使用 <h1>{{= title }}</h1> 般非 <%%>标识,也可以自定义的。

[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. var ejs = require('ejs');  
  2. ejs.open = '{{';  
  3. ejs.close = '}}';  
格式化输出也可以哦。
[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. ejs.filters.last = function(obj) {  
  2.   return obj[obj.length - 1];  
  3. };  
调用
[html]  view plain copy
  1. <p><%=: users | last %></p>  
EJS 也支持浏览器环境。
[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <html>  
  2.   <head>  
  3.     <script src="../ejs.js"></script>  
  4.     <script id="users" type="text/template">  
  5.       <% if (names.length) { %>  
  6.         <ul>  
  7.           <% names.forEach(function(name){ %>  
  8.             <li><%= name %></li>  
  9.           <% }) %>  
  10.         </ul>  
  11.       <% } %>  
  12.     </script>  
  13.     <script>  
  14.       onload = function(){  
  15.         var users = document.getElementById('users').innerHTML;  
  16.         var names = ['loki', 'tobi', 'jane'];  
  17.         var html = ejs.render(users, { names: names });  
  18.         document.body.innerHTML = html;  
  19.       }  
  20.     </script>  
  21.   </head>  
  22.   <body>  
  23.   </body>  
  24. </html>  

不知道 EJS 能否输出多层 JSON 对象呢?

对了,有网友爆料说,jQ 大神 John 若干年前写过 20 行的模板,汗颜,与 EJS 相似但短小精悍!

这里顺便贴一个高手写的(http://www.jiangkunlun.com/2012/05/js_%E6%A8%A1%E6%9D%BF/):

简单实用的js模板引擎

不足 50 行的 js 模板引擎,支持各种 js 语法:

[html]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. <script id="test_list" type="text/html">  
  2. <%=  
  3.     for(var i = 0l = p.list.length; i < l; i++){  
  4.         var stu = p.list[i];  
  5. =%>  
  6.     <tr>  
  7.         <td<%=if(i==0){=%> class="first"<%=}=%>><%==stu.name=%></td>  
  8.         <td><%==stu.age=%></td>  
  9.         <td><%==(stu.address || '')=%></td>  
  10.     <tr>  
  11.    
  12. <%=  
  13.     }  
  14. =%>  
  15. </script>  
“<%= xxx =%>”内是 js 逻辑代码,“<%== xxx =%>”内是直接输出的变量,类似 php 的 echo 的作用。“p”是调用下面 build 方法时的 k-v 对象参数,也可以在调用 “new JTemp” 时设置成别的参数名

调用:
[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. $(function(){  
  2.     var temp = new JTemp('test_list'),  
  3.         html = temp.build(  
  4.             {list:[  
  5.                    {name:'张三', age:13, address:'北京'},  
  6.                 {name:'李四', age:17, address:'天津'},  
  7.                 {name:'王五', age:13}  
  8.             ]});  
  9.     $('table').html(html);  
  10. });  
上面的 temp 生成以后,可以多次调用 build 方法,生成 html。以下是模板引擎的代码:
[javascript]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. var JTemp = function(){  
  2.     function Temp(htmlId, p){  
  3.         p = p || {};//配置信息,大部分情况可以缺省  
  4.         this.htmlId = htmlId;  
  5.         this.fun;  
  6.         this.oName = p.oName || 'p';  
  7.         this.TEMP_S = p.tempS || '<%=';  
  8.         this.TEMP_E = p.tempE || '=%>';  
  9.         this.getFun();  
  10.     }  
  11.     Temp.prototype = {  
  12.         getFun : function(){  
  13.             var _ = this,  
  14.                 str = $('#' + _.htmlId).html();  
  15.             if(!str) _.err('error: no temp!!');  
  16.             var str_ = 'var ' + _.oName + '=this,f=\'\';',  
  17.                 s = str.indexOf(_.TEMP_S),  
  18.                 e = -1,  
  19.                 p,  
  20.                 sl = _.TEMP_S.length,  
  21.                 el = _.TEMP_E.length;  
  22.             for(;s >= 0;){  
  23.                 e = str.indexOf(_.TEMP_E);  
  24.                 if(e < s) alert(':( ERROR!!');  
  25.                 str_ += 'f+=\'' + str.substring(0, s) + '\';';  
  26.                 p = _.trim(str.substring(s+sl, e));  
  27.                 if(p.indexOf('=') !== 0){//js语句  
  28.                     str_ += p;  
  29.                 }else{//普通语句  
  30.                     str_ += 'f+=' + p.substring(1) + ';';  
  31.                 }  
  32.                 str = str.substring(e + el);  
  33.                 s = str.indexOf(_.TEMP_S);  
  34.             }  
  35.             str_ += 'f+=\'' + str + '\';';  
  36.             str_ = str_.replace(/\n/g, '');//处理换行  
  37.             var fs = str_ + 'return f;';  
  38.             this.fun = Function(fs);  
  39.         },  
  40.         build : function(p){  
  41.             return this.fun.call(p);  
  42.         },  
  43.         err : function(s){  
  44.             alert(s);  
  45.         },  
  46.         trim : function(s){  
  47.             return s.trim?s.trim():s.replace(/(^\s*)|(\s*$)/g,"");  
  48.         }  
  49.     };  
  50.     return Temp;  
  51. }();  

核心是将模板代码转变成了一个拼接字符串的 function,每次拿数据 call 这个 function。

因为主要是给手机(webkit)用的,所以没有考虑字符串拼接的效率问题,如果需要给 IE 使用,最好将字符串拼接方法改为 Array.push() 的形式。

网友作品:cocoTemplate

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值