首页 > 网站 > WEB开发 > 正文

4行代码实现js模板引擎

2024-04-27 14:19:59
字体:
来源:转载
供稿:网友

4行代码实现js模板引擎

在平时编码中,经常要做拼接字符串的工作,如把json数据用HTML展示出来,以往字符串拼接与逻辑混在在一起会让代码晦涩不堪,加大了多人协作与维护的成本。而采用前端模板机制就能很好的解决这个问题。

精妙的 tmpl

前端模板类开源的不少,但最属 jQuery 作者 John Resig 开发的 “javascript micro templating” 最为精妙,寥寥几笔便实现了模板引擎核心功能。 它的介绍与使用方式请看作者博客:http://ejohn.org/blog/Javascript-micro-templating/

麻雀虽小,五脏俱全,除了基本的数据附加外,还拥有缓存机制、逻辑支持。现在,若要我评出一个javascript 最节能的自定义函数排名,第一名是 $ 函数(document.getElementById 简版),而第二名就是 tmpl 了。

当然,它并非完美,我使用过程中发现了一些问题:

tmpl 美中不足

一、无法正确处理转义字符,如: tmpl('<%=name%>//<%=id%> ', {name:'糖饼', id: '1987'});它就会报错。若正常工作,它应该输出:糖饼/1987

二、无法识别数据里的单引号

三、设置变量默认值复杂,如

tmpl('<%if(obj.name){%><%=name%><%}else{%>默认值<%}%> ', {name:'糖饼'}); //设置name默认为 “默认值”

tmpl 优化版本

废话不多说,先敬上代码:

 1 function tmpl(str, data) { 2     var $ = '$' + (+ new Date) 3         , fn = function (data) { 4         var i, variable = [$], value = [[]]; 5         for (i in data) { 6             variable.push(i); 7             value.push(data[i]); 8         } 9         return (new Function(variable, fn.$))10             .apply(data, value).join("");11     };12 13     //将模板解析成函数14     fn.$ = fn.$ || $ + ".push('"15         + str.replace(////g, "////")16             .replace(/'/g, "//'")  //防止单括号错误17             .replace(/[/r/t/n]/g, " ")18             .split("[:").join("/t")19             .replace(/((^|:])[^/t]*)'/g, "$1/r")20             .replace(//t=([^/?]*?):]/g, "',$1,'")21             .replace(//t=([^/?]*?)/?(.*?):]/g, "',this.$1||'$2','")   //  [:=data?:]  [:=data?任何内容:]22             .split("/t").join("');")23             .split(":]").join($ + ".push('")24             .split("/r").join("//'")25         + "');return " + $;26 27     //如果未定义data则返回编译好的函数,使用时直接传入数据即可,28     //省去每次解析成函数的时间29     return data ? fn(data) : fn;30 31 };    

好吧,上面的代码看起来超出了4行,原谅我标题党。不过这段代码经过压缩后,确实只有四行^_^。下面我们就来详细解构它。

首先看一下使用示例:

 1 //循环结构 2  3 var tpl = '[: for(var k in ary){ var one=ary[k]; :]' 4         + '<p>[:=one:]</p>' 5         + '[: } :]'; 6 var data = {ary:[123,'abc']}; 8 var div = tmpl(tpl,data);10 console.log(div); //</p>123</p><p>abc</p>11 12 13 //变量验证14 15 var tpl = '[: if(this.name!==undefined){ :]' //注意必须使用 this.name,直接使用name,如果未定义就会报错16 + '<p>[:=name:]</p>'17 + '[: } :]';18 var data = {name:'abc'};20 var div = tmpl(tpl,data);22 23 //你还可以这样方便地使用未定义的变量:24 25 var tpl = '<p>name:[:=name?:], name:[:=name?默认值:]</p>';26 var data = {no:'abc'};27 var div = tmpl(tpl,data);28 29 console.log(div); // <p>name:, name:默认值</p>30 31 32 //缓存编译结果33 34 35 var tpl = '[: for(var k in ary){ var one=ary[k]; :]'36 + '<p>[:=one:]</p>'37 + '[: } :]';38 var data = {ary:[123,'abc']};40 var render = tmpl(tpl); //不传入data,则生成缓存,多次使用缓存节约大量正则运算42 var div = render(data); //传入data,代入变量,解析成最终结果43 44 console.log(div); //<p>123</p><p>abc</p>

使用方法:在 [: 与:] 之间使用任何js代码,并且通过 [:=data:] 方式以字符串形式输出变量。更加详细的使用方法/手册,请查看:http://docs.codekart.jojoin.com/p/tool_tmpl

优化的地方:

一. 正确处理转义字符 / ' 等转义字符

二. 修改包裹符 <% %> 为 [: :] 防止与 html标签</>和求余运算符%产生冲突。

三. 修改环境变量 obj 为 this

tmpl('<%if(obj.name=="name")%>') //旧版本

tmpl('[: if(this.name=="name") :]') //新版本

四. 为变量添加默认值

tmpl('<%if(obj.name){%><%=name%><%}else{%>默认值<%}%>') //旧版本

tmpl('[:=name?默认值:]') //新版本

五. 去掉 with 语句,大幅提升引擎性能

六. 删除可有可无的功能,保持精简

七. 增加调试模式

//打印模板编译中间结果:

console(tmpl('<p>[:=name:]</p>').$);

//$1408707567855.push('<p>',name,'</p>');return $1408707567855

此引擎函数大致分为两部分:

一. 上半部分:模板函数解析执行

二. 下半部分:正则运算生成模板函数

可以看出,引擎实现的重点主要在下半部分的一堆正则表达式,也就是“模板编译”的过程。这里我不打算把每一个正则的功能都说清楚,那样篇幅太大(好吧是我懒),各位看官请自行阅读研究。

另外,此模板引擎已被集成到 Node.jsweb开发框架 Codekart中。

Codekart 是一套给 Node.js 开发者使用的应用程序开发框架和工具包。 它提供一套丰富的标准库以及简单的接口和逻辑结构, 其目的是使开发人员更快速地进行项目开发。 使用 Codekart 可以减少代码的编写量, 并将你的精力投入到项目的创造性开发上。

它已经帮你出色的完成了下面这些事情:

优雅的框架思维

如果你需要一个真正的框架,而不是一个模块/中间件/工具箱,如果你需要简约与便捷,需要一目了然、理所当然的舒适感,那么 Codekart 将是最好的选择。

高性能 HTTP 服务器

Codekart 处理 http 请求的性能接近原生 Node.js 代码: http.createServer(), 原因是框架只是对此函数做了简单的封装,其性能的损耗仅仅只有一个 url 正则匹配运算,路由请求处理程序。

便捷的静态文件服务器

把文件放入 static/ 目录下,启动Codekart,url 访问,搞定!

web 页面模块化支持

实际上,这是Codekart最出色的部分!它是前后端一体化的,可以像写配置文件一样编写web页面, 框架自动完成 js、CSS 、tpl 文件的模块化加载、合并、压缩, 并在html里引用,自动完成 html 模板的解析,并且支持页面继承和多态,一切就是那么简单轻松!

丰富的工具箱

Codekart 准备了一系列强大的前后端工具集合,涉及进程通信,数据缓存,文件读取,文件上传,数据采集与处理,流程控制,任务计划等诸多方面。

框架源码托管在Github:https://github.com/yangjiePRo/Codekart欢迎提交新的代码!


发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表