概述

template.js是一个基于 jquery 的前端 javascript 模板,插件主要解决数据渲染时的繁琐的数据处理。模板解决了html片段连接效率低下和繁琐的问题。看了很多相关的博客,博客内容几乎一样,很多知识点并没有详细的说明,对此经过两天的实验研究,把研究的结果记录下来。

模板标签

1.{{each}}:双标签,用于遍历对象,数组或者 json 对象。

2.{{if}}:双标签,用于数据类型的判断,条件可以是表达式。

3.{{else}}:单标签,配合 {{if}} 标签使用。

4.{{html}}:单标签,用于解析含有 html 片段的字符串。

5.{{tmpl}}:单标签,用于模板的嵌套。

6.{{wrap}}:双标签,包装器,(没有发现使用的奥秘,欢迎指点)

模板的常用变量和方法

有用的常量:

(1) ${var}:输出变量

(2) {{= var}}:输出变量,注意等号后面必须紧跟空格

(3) $item:表示当前模板

(4) $data:表示数据源,即模板注入的数据

(5) $index:表示在使用 each 时的索引

(6) $value:表示在使用 each 时的键值

方法:

(1) $.tamplate(name,str):将指定的html代码段转化成指定名称的模板,name模板名称,str代码片段,

并将数据缓存。

(2) $.tmpl(name,data):核心方法,将数据注入模板,并解析模板,name模板名称,data:数据源

(3) $.tmplItem(ele):获取使用模板渲染的指定元素上的数据,ele表示DOM节点

(4) $(ele).tmpl(data):局部方法,获取模板,向模板中注入数据,并解析模板

(5) $(ele).tmplItem():获取使用模板渲染的指定元素上的数据,ele表示DOM节点

(6) $(ele).template(name):将数据缓存在ele节点,缓存的key为name

看源码发现局部方法最终调用的是全局的方法,所以在全局的方法是template.js的核心,局部方法只是辅助

功能,为用户提供更灵活的方式获取模板,为模板注入数据,解析模板。

标签的使用

{{each}}

标签为双标签,使用时必须使用{{/each}}标签结束,在使用时需要注意一下几点:

(1) 在数据源为数组时,并不需要使用这个标签,模板会自动遍历数组。

(2)

使用方式一:

{{each array|jsonObject}},将数组或json对象放在标签名称的后面,

实现的遍历方式,与 jquery 中的全局方法 $.each() 相同。源码中也是通过 $.each() 实现的。

使用这种方式,需要使用模板变量 $index 表示索引,$value 表示索引值。

使用方式二:

{{each(key,value) array|jsonObject}},使用此方式与方式一基本相同,唯一不同的是,

此时指定了遍历时的 key 和 value取代了模板变量 $index 和 $value,

同时不能使用 $index和 $value。

(3) 需要注意的是,数据源的问题,若果使用的不是数组,而是复杂的数据类型,可以使用模板嵌套的方式,

解析数据类型为数组的键值,这样就避免了多次使用each标签。

{{if}}

标签为双标签,使用时必须使用{{/if}}标签结束,使用方法:

(1) {{if condition}} : condition 为条件表达式,和普通if基本相同。

(2) 在逻辑判断时配合{{else}}使用,所有的{{else}}标签必须包含在{{if}}{{/if}}内。

{{html}}

{{tmpl}}

{{wrap}}