在我的一篇关于智能搜索框异步加载数据的文章中,有博友给我留言,认为我手写字符串拼接效率过低,容易出错。在经过一段时间的摸索和学习之后,发现现在拼接字符串的方法都不在是自己去书写了,而是使用Javascript引擎。而javascript引擎的实质就是帮我们把带有JavaScript代码的伪THTML语句编译为HTML。
如果有不了解的朋友,可以前往这两篇文章:
源码地址:
回归正题,以下对artTemplate模板引擎的介绍会分为如下几部分内容:
1.artTemplate模板引擎的基本语法结构
2.artTemplate模板引擎的基本使用方法
2.1:使用一个type="text/html"的script标签存放模板
2.2:在javascript中存放模板
2.3:嵌入子模板(include)
3.artTemplate模板引擎使用实战
1.artTemplate基本语法结构
artTemplate的语法结构很简单,就是{{}}。{{}} 符号包裹起来的语句则为模板的表达式。表达式又分为 输出表达式,条件表达式,遍历表达式,模板包含表达式。具体的可以看看GitHub:artTemplate 简洁语法版。官网对语法介绍的还可以,不过在这里想在说一句,要记住表达式的写法和表达式有哪些分类,对于理解引擎很有帮助。
2.artTemplate模板引擎的使用方法
首先,需要去官网下载 简洁语法版 ,然后在body底部加载script文件。文件很小,只有2.7kb,可是功能十分强大。
2.1:使用一个type="text/html"的script标签存放模板
使用script存放模板的时候要注意两个方面。
一方面是必须给script标签定义id,而且只能是id,不能是class。因为在使用template(id,data)方法的时候,该方法会根据id渲染模板,引擎内部会根据document.getElementById(id)查找模板。如果使用class作为参数,artTemplate引擎会报错。如果没有 data 参数,将返回一渲染函数。
另外一方面是在<!DOCTYPE html>script标签中的type类型默认为type/javascript。在script标签中,必须重新声明type类型为text/html,否则会没有效果。
使用方法如下
<script >
<h1>{{title}}</h1>
<ul>
{{each list as value i}}
<li>索引{{i+1}} : {{value}}</li>
{{/each}}
</ul>
</script>
<script>
var data = {
title:'My Life',
list:['篮球','桌球','游泳','滑轮','读书']
};
var html = template('test',data);
$('.rascal').html(html);
</script>
渲染的页面如下:
2.2:在Javascript中存放模板
在Js中存放模板应该会很少用到,因为在前端领域有一条军规,结构样式和行为三者必须分离。如果把模板放在js文件内,会破坏这条规定。
看看例子,知道一下调用的规则。实质上就是一段拼接字符串的过程。
<script type="text/javascript">
var source ="<ul>"
+ "{{each list as value i}}"
+ "<li>索引{{i+1}}:{{value}}</li>"
+ "{{/each}}"
+ "</ul>";
var render = template.compile(source);
var html = render({
list:['篮球','桌球','游泳','滑轮','读书']
});
$('.rascal').html(html);
</script>
2.3:嵌入子模板(include)
嵌套模板跟第一种方法原理相同,只不过在一个模板中调用了另外一个模板而已。
<script id='test' type='text/html'>
<h1>My Life</h1>
{{include 'list'}}
</script>
<script id='list' type='text/html'>
<ul>
{{each list as value i}}
<li>索引{{i+1}}:{{value}}</li>
{{/each}}
</ul>
</script>
<script>
var data = {
"list":['篮球','桌球','游泳','滑轮','读书']
};
var html = template('test',data);
$('.rascal').html(html);
</script>
3.artTemplate模板引擎使用实战
artTemplate官网给出的每一个例子其实都已经很好了,可以让每一个人都很容易的明白。不过我认为唯一的缺点就是,例子中的数据完全都是自己定义的。在实际开发中,用户看到的每一个商品数据是这样来的:首先后端攻城狮通过特定语法连接数据库,然后将从数据库中获取的数据转换成JSON格式,最后前端攻城狮在通过一些方法将JSON数据渲染到页面上。所以我们的数据不能自己瞎造,而是通过Ajax异步加载。
在我的一篇 淘宝购物车页面 智能搜索框Ajax异步加载数据 文章中,一开始是使用手写拼接字符串的方法去拼接字符串,这种方法效率低,容易出错。后来全部改成了js模板引擎的方法。所以我会以淘宝购物车页面中智能搜索框Ajax异步加载商品数据的例子来说明artTemplate模板引擎。
先放上一段代码。主要还是想通过这个简单的例子说明接下来要探讨的问题。
<script >
<h1>{{title}}</h1>
<ul>
{{each list as value i}}
<li>索引{{i+1}} : {{value}}</li>
{{/each}}
</ul>
</script>
<script>
var data = {
title:'My Life',
list:['篮球','桌球','游泳','滑轮','读书']
};
var html = template('test',data);
$('.rascal').html(html);
</script>
上面代码中,要注意几点的就是:
♥ 遍历表达式中的list必须与脚本中data对象中的list同名,而且遍历表达式中的list必须是data对象中的一个属性。循环表达式中,要循环的是每一个data对象中的list数组,而不是data对象,这点很重要。
在这个例子中,data对象中list属性是一个数组,数组中的每一个值都是简单数据类型,篮球桌球等。当然,可以往数组中传入复杂数据类型,如对象。说明这个主要是因为在循环表达式中循环的数据和给template()传入第二个参数的时候很容易出错。
♥ 使用template方法时,第一个参数必须是id,而不能是class。
放上一段json数据代码。
[ [ { "Query":"lan", "Results":[ { "Type":"AS", "Suggests":[ { "Txt":"李宁2016新款男子篮球鞋音速3高帮反弹篮球场地鞋ABAL031", "num":339, "max":764, "discount":200, "label":"liningBas", "shop":"李宁官方网店", "image":"css/images/lining-bas.png", "color":"颜色分类:荧光果粉/木梅红", "size":"鞋码:42", "nonDiscount":"¥539.00", "bandCard":"css/images/bankCard.png", "sevenDay":"css/images/sevenDay.png", "guarantee":"css/images/guarantee.png" }, { "Txt":" adidas阿迪达斯篮球男子篮球鞋Regulate", "num":419, "max":18, "discount":120, "label":"adidas", "nonDiscount":"¥539.00", "image":"css/images/adidas.png", "color":"颜色分类:银金属/深藏青蓝", "shop":"adidas官方旗舰店", "size":"鞋码:43.5", "bandCard":"css/images/bankCard.png", "sevenDay":"css/images/sevenDay.png", "guarantee":"css/images/guarantee.png" } ] } ] } ], [ { "Query":"音速3", "Results":[ { "Type":"AS", "Suggests":[ { "Txt":"李宁2016新款男子篮球鞋音速3高帮反弹篮球场地鞋ABAL031", "num":339, "max":764, "label":"liningBas", "shop":"李宁官方网店", "image":"css/images/lining-bas.png", "color":"颜色分类:荧光果粉/木梅红", "size":"鞋码:42", "nonDiscount":"¥539.00", "bandCard":"css/images/bankCard.png", "sevenDay":"css/images/sevenDay.png", "guarantee":"css/images/guarantee.png" } ] } ] } ] ]