jQuery Templates模板插件

jQuery团队提供了一个模板插件,但非常可惜的是jquery团队放弃对其维护,我们对其方法和语法进行简单简绍

源码官方的网址:

http://api.jquery.com/category/plugins/templates

文档的网址:

http://api.jquery.com/category/plugins/templates

使用该插件必须先引入对应js

//依赖jquery
<script src="http://code.jquery.com/jquery.js" type="text/javascript"></script>
//tmpl核心js文件
<script src="../../../jquery.tmpl.js" type="text/javascript"></script>

 使用的语法:

jQuery.tmpl( template [, data] [, options] ) 返回值为: jQuery

template为模板

data为对应数据

options为其它参数

1.这个语法是我们直接使用模板字符串

例子:

//模板字符串
var tmpl = '<li><a href="${url}">${getName()}</a> {{if $item.showCities}}(${cityJoin()}){{/if}}</li>';
$.tmpl( tmpl, dataObject ).appendTo( "ul" );
//或者
$.tmpl( "<li>${Name}</li>", { "Name" : "John Doe" }).appendTo( "#target" );

2.还可以定义模板完了使用模板

定义模板:

<!--定义模板-->
<script id="movieTemplate" type="text/x-jquery-tmpl">
	<li>
		<b>${Name}</b> (${ReleaseYear})
	</li>
</script>

 注意:定义模板使用的script标签,不过type为text/x-jquery-tmpl

 3.编译缓存模板

在jQuery .tmpl()中,还可以将模板事先编译并缓存起来,然后在合适的时侯再使用,这对于一些数据嵌套是很有用的

<script id="compile1" type="text/x-jquery-tmpl">
{{tmpl 'cached'}}
<tr><td>${ID}</td><td>${Name}</td></tr>
</script>
<script id="compile2" type="type/x-jquery-tmpl">
<tr><td colspan="2">${Group}</td></tr>
</script>
<script type="text/javascript">
$(function () {
var groupUsers = [{ ID: 'think8848', Name: 'Joseph Chan', Group: 'Administrators' }, { ID: 'aCloud', Name: 'Mary Cheung', Group: 'Users'}];
$('#compile2').template('cached');
$('#compile1').tmpl(groupUsers).appendTo('#compileRows');
});
</script>

使用模板:

<script type="text/javascript">
	//模板数据
	var movies = [
		{ Name: "The Red Violin", ReleaseYear: "1998" },
		{ Name: "Eyes Wide Shut", ReleaseYear: "1999" },
		{ Name: "The Inheritance", ReleaseYear: "1976" }
	];
	//movieTemplate为模板id
	$( "#movieTemplate" ).tmpl( movies ).appendTo( "#movieList" );
</script>

 temp插件支持的功能:

${}直接显示数据另一种写法{{= field}},里面如果有html标签也不识别

{{html}}显示数据并识别解析标签

<script id="movieTemplate" type="text/x-jquery-tmpl">
	<tr>
		<td>${Title}</td>
		<td class="synopsis">${Synopsis}</td>
		<td class="synopsis">{{html Synopsis}}</td> 
	</tr>
</script>

 {{if}} 和 {{else}}支持条件判断

<script id="movieTemplate" type="text/x-jquery-tmpl">
	<tr>
		<td>${Title}</td>
		<td>
			{{if Languages}}
				Alternative languages: <em>${Languages}</em>.
			{{else Subtitles}}
				Original language only... <br/>Subtitles in <em>${Subtitles}</em>.
			{{else}}
				Original version only, without subtitles.
			{{/if}}
		</td>
	</tr>
</script>

{{each}}循环

通过$value来取循环对象值例如$value.Name取到循环对象的Name属性值

<script id="movieTemplate" type="text/x-jquery-tmpl">
	<tr>
		<td>${Title}</td>
		<td>Languages:
			<em>
				{{each Languages}}
					${$value.Name} and ${$value.value}
				{{/each}}
			</em>
		</td>
	</tr>
</script>

{{each}}还有另一种写法

<script id="each2" type="text/x-jquery-tmpl">
	<li>ID: ${ID}; Name: ${Name};<br />Langs:
		<ul>
			<STRONG>
				{{each(i,lang) Langs}}
					<li>${i + 1}: <label>${lang}. </label></li>
				{{/each}}
			</STRONG>
		</ul>
	</li>
</script>

 {{wrap}},包装器,这回不需要指定对哪一个元素使用模板了,直接生成模板的包装器

$.tmplItem()方法,使用这个方法,可以获取从render出来的元素上重新获取$item

$('tbody').delegate('tr', 'click', function () {
    var item = $.tmplItem(this);
     alert(item.data.Name);
});

 $.template(),将一段Html编译为模板

var markup = '<tr><td>${ID}</td><td>${Name}</td></tr>';
$.template('template', markup);
$.tmpl('template', users).appendTo('#templateRows');
 jQuery .tmpl()有两个比较有用的属性:$item、$data:
$item代表当前的模板;$data代表当前的数据

相关推荐