JavaScript模板引擎原理与用法

这篇文章主要介绍了JavaScript模板引擎原理与用法,结合实例形式详细分析了javascript模版引擎相关概念、原理、定义及使用方法,写的十分的全面细致,具有一定的参考价值,对此有需要的朋友可以参考学习下。如有不足之处,欢迎批评指正。

一、前言

什么是模板引擎,说的简单点,就是一个字符串中有几个变量待定。比如:

vartpl ='Hei, my name is <%name%>, and I\'m <%age%> years old.';

通过模板引擎函数把数据塞进去,

var data = {

  "name": "Barret Lee",

  "age": "20"};var result = tplEngine(tpl, data);//Hei, my name is Barret Lee, and I'm 20 years old.

那这玩意儿有什么作用呢?其实他就是一个预处理器(preprocessor),搞php开发的童鞋对Smarty必然是十分熟悉,Smarty是一个php模板引擎,tpl中待处理的字符通过数据匹配然后输出相应的html代码,加之比较给力的缓存技术,其速度和易用性是非常给力的!JS Template也是一样的,我们的数据库里保存着数以千万计的数据,而每一条数据都是通过同一种方式输入,就拿上面的例子来说,我们不可能在数据库里存几千条"Hei, my name...",而是只保存对应的name和age,通过模板输出结果。

JS模板引擎应该做哪些事情?看看下面一串代码:

var tpl = '<% for(var i = 0; i < this.posts.length; i++) {' + 

  'var post = posts[i]; %>' +

  '<% if(!post.expert){ %>' +

    '<span>post is null</span>' +

  '<% } else { %>' +

    '<a href="#" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" ><% post.expert %> at <% post.time %></a>'

一个基本的模板引擎至少可以保证上面的代码可以正常解析。如送入的数据是:

var data = {

  "posts": [{

    "expert": "content 1",

    "time": "yesterday"  },{

    "expert": "content 2",

    "time": "today"  },{

    "expert": "content 3",

    "time": "tomorrow"  },{

    "expert": "",

    "time": "eee"  }]

};

可以输出

content 1 at yesterdaycontent 2 at todaycontent 3 at tomorrowpost is null

下面就具体说说这个模板引擎的原理是啥样的。

二、JS模板引擎的实现原理

1.正则抠出要匹配的内容 针对这一串代码,通过正则获取内容

var tpl = 'Hei, my name is <%name%>, and I\'m <%age%> years old.';var data = {

  "name": "Barret Lee",

  "age": "20"

最简单的方式就是通过replace函数了:

var result = tpl.replace(/<%([^%>]+)?%>/g, function(s0, s1){

  return data[s1];

});

通过正则替换,我们很轻松的拿到了result,你可以去试一试,他正是我们想要的结果。但是这里又有了一个问题,改一下data和tpl,

var data = {

  "name": "Barret Lee",

  "info": { age": "20"}

};

再用上面的方式去获取结果,呵呵,不行了吧~ 这里data["info.age"]本身就是undefined,所以我们需要换一种方式来处理这个问题,那就是将它转换成真正的JS代码。如:

return 'Hei, my name is ' + data.name + ', and I\'m ' + data.info.age' + ' years old.'

但是接着又有一个问题来了,当我们的代码中出现for循环和if的时候,上面的转换明显是不起作用的,如:

var tpl = 'Posts: ' +

    '<% for(var i = 0; i < post.length; i++) {'+

      '<a href="#"

如果继续采用上面的方式,得到的结果便是:

return 'Posts: ' +

    for(var i = 0; i < post.length; i++) { +

    '<a href="#" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" >' + post[i].exper + '</a>' +

    }

这显然不是我们愿意看到的,稍微观察一下上面的结构,如果可以返回一个这样的结果也挺不错哦:

'Posts: 'for(var i = 0; i < post.length; i++) {  '' + post[i].exper + ''}//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:619586920

但是我们需要得到的是一个字符串,而不是上面这样零散的片段,因此可以把这些东西装入数组中。

2.装入数组

var r = [];r.push('Posts: ' );r.push(for(var i = 0; i < post.length; i++) {);r.push('');r.push(post[i].exper);r.push('');r.push(});

有人看到上面的代码就要笑了,第三行和最后一行代码的逻辑明显是不正确的嘛,那肿么办呢?呵呵,很简单,不放进去就行了呗,

var r = [];r.push('Posts: ' );for(var i = 0; i < post.length; i++) {  r.push('');  r.push(post[i].exper);  r.p//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:619586920

这样的逻辑就十分完善了,不存在太多的漏洞,但是这个转化的过程是如何实现的?我们必须还是要写一个解析的模板函数出来。 3.分辨js逻辑部分

varr = [];tpl.replace(/<%([^%>]+)?%>/g,function(s0, s1){//完蛋了,这里貌似又要回到上面那可笑的逻辑有错误的一步啦... 该怎么处理比较好?});

完蛋了,这里貌似又要回到上面那可笑的逻辑有错误的一步啦... 该怎么处理比较好?我们知道,JS给我们提供了构造函数的“类”,

varfn =newFunction("data","var r = []; for(var i in data){ r.push(data[i]); } return r.join(' ')");fn({"name":"barretlee","age":"20"});// barretlee 20

道了这个就好办了,我们可以把逻辑部分和非逻辑部分的代码链接成一个字符串,然后利用类似fn的函数直接编译代码。而/<%([^%>]+)?%>/g,这一个正则只能把逻辑部分匹配出来,要想把所有的代码都组合到一起,必须还得匹配非逻辑部分代码。replace函数虽然很强大,他也可以完成这个任务,但是实现的逻辑比较晦涩,所以我们换另外一种方式

varreg =/<%([^%>]+)?%>/g;vartpl ='Hei, my name is <%name%>, and I\'m <%age%> years old.';varmatch = reg.exec(tpl);console.log(match);

看到的是:

[0:"<%name%>",1: name,index:16,  input:"Hei, my name is <%name%>, and I'm <%age%> years old."length:2]//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:798891710

这。。。我们可是想得到所有的匹配啊,他竟然只获取了name而忽略了后面的age,好吧,对正则稍微熟悉点的童鞋一定会知道应该这样处理:

varreg =/<%([^%>]+)?%>/g;while(match = reg.exec(tpl)) {console.log(match);}

关于正则表达式的内容就不在这里细说了,有兴趣的同学可以多去了解下match,exec,search等正则的相关函数。这里主要是靠match的index属性来定位遍历位置,然后利用while循环获取所有的内容。 4.引擎函数

所以我们的引擎函数雏形差不多就出来了:

vartplEngine =function(tpl, data){varreg =/<%([^%>]+)?%>/g,      code ='var r=[];\n',      cursor =0;//主要的作用是定位代码最后一截varadd =function(line){    code +='r.push("'+ line.replace(/"/g,'\\"') +'");\n';  };//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:619586920while(match = reg.exec(tpl)) {    add(tpl.slice(cursor, match.index));//添加非逻辑部分add(match[1]);//添加逻辑部分 match[0] = "<%" + match[1] + "%>";cursor = match.index + match[0].length;  }//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:619586920add(tpl.substr(cursor, tpl.length - cursor));//代码的最后一截 如:" years old."code +='return r.join("");';// 返回结果,在这里我们就拿到了装入数组后的代码console.log(code);returntpl;};

这样一来,测试一个小demo:

var tpl = '<% for(var i = 0; i < this.posts.length; i++) {' +     'var post = posts[i]; %>' +    '<% if(!post.expert){ %>' +      'post is null' +    '<% }else{ %>' +      '<% post.expert %> at <% post.time %>' +    '<% } %>' +  '<% } %>';

返回的结果让人很满意:

varr=[];r.push("");r.push(" for(var i = 0; i < this.posts.length; i++) {var post = posts[i]; ");r.push("");r.push(" if(!post.expert){ ");r.push("<span>post is null</span>");r.push(" } else { ");r.push("<a href=\"#\">");r.push(" post.expert ");r.push(" at ");r.push(" post.time ");r.push("</a>");r.push(" } ");r.push("");r.push(" } ");r.push("");

不过我们并需要for,if,switch等这些东西也push到r数组中去,所以呢,还得改善下上面的代码,如果在line中发现了包含js逻辑的代码,我们就不应该让他进门:

regOut = /(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g;varadd =function(line, js){  js? code += line.match(regOut) ? line +'\n':'r.push('+ line +');\n':    c

所以我们只剩下最后一步工作了,把data扔进去!

5.把data扔进去

没有比完成这东西更简单的事情啦,通过上面对Function这个函数的讲解,大家应该也知道怎么做了。

returnnewFunction(code).apply(data);

使用apply的作用就是让code中的一些变量作用域绑定到data上,不然作用域就会跑到global上,这样得到的数据索引就会出问题啦~ 当然我们可以再优化一下:

returnnewFunction(code.replace(/[\r\t\n]/g,'')).apply(data);

把回车换行以及tab键都给匹配掉,让代码更加干净一点。那么最终的代码就是:

vartplEngine =function(tpl, data){varreg =/<%([^%>]+)?%>/g,    regOut =/(^( )?(if|for|else|switch|case|break|{|}))(.*)?/g,    code ='var r=[];\n',    cursor =0;varadd =function(line, js){    js? (code += line.match(regOut) ? line +'\n':'r.push('+ line +');\n') :      (code += line !=''?'r.push("'+ line.replace(/"/g,'\\"') +'");\n':'');returnadd;  }//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:619586920while(match = reg.exec(tpl)) {    add(tpl.slice(cursor, match.index))(match[1],true);    cursor = match.index + match[0].length;  }  add(tpl.substr(cursor, tpl.length - cursor));  code +='return r.join("");';returnnewFunction(code.replace(/[\r\t\n]/g,'')).apply(data);};

三、应用场景

毕竟是前端代码,所以写出来是要为前端服务的,平时我们处理的一般是一个html的模板,通常的情况下,模板代码是放在script标签或者textarea中,所以首先是要获取到这里头的东西,然后再来做解析。

varbarretTpl =function(str, data){//获取元素varelement =document.getElementById(str);if(element) {//textarea或input则取value,其它情况取innerHTMLvarhtml =/^(textarea|input)$/i.test(element.nodeName) ? element.value : element.innerHTML;returntplEngine(html, data);  }else{//是模板字符串,则生成一个函数//如果直接传入字符串作为模板,则可能变化过多,因此不考虑缓存returntplEngine(str, data);  }//vartplEngine =function(tpl, data){// content above};};

这样一来就更加简单了,使用方式就是 barretTpl(str, data), 这里的str可以是模板代码,也可以是一个DOM元素的id~

四、优化以及功能拓展

总共就三四十行代码,完成的东西肯定是一个简洁版的,不过对于一个简单的页面而言,这几行代码已经足够使用了,如果还想对他做优化,可以从这几个方面考虑:

优化获取的模板代码,比如去掉行尾空格等

符号转义,如果我们想输出<span>hehe</span>类似这样的源代码,在push之前必须进行转义 代码缓存,如果一个模板会经常使用,可以将它用一个数组缓存在barretTpl闭包内

用户自己设置分隔符

结语

感谢您的观看,如有不足之处,欢迎批评指正。


©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,657评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,889评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,057评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,509评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,562评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,443评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,251评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,129评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,561评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,779评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,902评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,621评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,220评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,838评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,971评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,025评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,843评论 2 354

推荐阅读更多精彩内容