jQuery .tmpl() 用法

参考效果: DEMO  下载: jquery-tmpl-master

动态请求数据来更新页面是现在非常常用的方法,比如博客评论的分页动态加载,微博的滚动加载和定时请求加载等。

这些情况下,动态请求返回的数据一般不是已拼好的 HTML 就是 JSON 或 XML,总之不在浏览器端拼数据就在服务器端拼数据。不过,从传输量方面来看,返回 HTML 不划算,而在 web 传输方面,现在更多的是使用 JSON 而不是 XML。

浏览器端根据 JSON 生成 HTML 有个很苦恼的地方就是,结构不复杂的时候还好,结构一复杂,就想死了,需要很小心很小心地写出几乎无法维护的 JavaScript 代码。

如同为解决 PHP 拼数据这方面的问题而有了 Smarty 这些模版,JavaScript 也可以利用模版来解决这些问题,比如基于 jQuery 的 jquery.tmpl,现在已经被接受为官方的模版插件了。详细的 API 在 jQuery 的 Templates 里,内置的 demo 也尽情地演示了各种用法。

就我自己的几次使用,感觉很不错,用更加直观方面的 HTML 写法而不是 JavaScript 拼凑 来写结构,然后用 JSON 变量来占位的方式来填充数据,代码看起来好多了。

Tmpl提供了几种tag:

${}:等同于{{=}},是输出变量,通过了html编码的。
{{html}}:输出变量html,但是没有html编码,适合输出html代码。
{{if }} {{else}}:提供了分支逻辑。
{{each}}:提供循环逻辑,$value访问迭代变量。

jquery tmpl的使用方法:

模板定义:
方法一:

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

方法二:

function makeTemplate(){
var markup=’<li><b>${Name}</b> (${ReleaseYear})</li>‘;
$.template(“movieTemplate”, markup);
}

DATA:

var movies = [
{ Name: "The Red Violin", ReleaseYear: "1998" },
{ Name: "Eyes Wide Shut", ReleaseYear: "1999" },
{ Name: "The Inheritance", ReleaseYear: "1976" }
];

Script:

$( "#movieTemplate" ).tmpl( movies ).appendTo( "#movieList" );

参考效果: DEMO  下载: jquery-tmpl-master

实例1:

<!DOCTYPE html>
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
  <script src="http://ajax.microsoft.com/ajax/jquery.templates/beta1/jquery.tmpl.min.js"></script>
</head>
<body>
	
	<ul class="param-list"></ul>
            
	<script type="text/x-jquery-tmpl" id="new-param-tmpl">
		<li rel="${num}">
			<input type="text" name="key[${num}]" value="${key}" placeholder="key" /> = 
			<input type="text" name="value[${num}]" value="${value}" placeholder="value" /> 
			<button type="button" class="button small remove-param"><img src="http://mediacdn.disqus.com/1338845651/images/v3/icon/16/69.png" height="12" alt=""/></button> 
			<button type="button" class="button small add-param"><span><img src="http://mediacdn.disqus.com/1338845651/images/v3/icon/16/13.png" height="12" alt=""/></button>
		</li>
	</script>

	<script>
		$(function(){
			function addParam(key, value) {
				var param_list = $('.param-list');
				var num = param_list.find('li').length;

				// build a template to clone the current row
				var built = $('#new-param-tmpl').tmpl({
					num: num,
					key: key || '',
					value: value || '',
				});
				if (key) param_list.prepend(built);
				else param_list.append(built);

				param_list.find('li:not(:last) .add-param').hide();
				param_list.find('li:last .add-param').show();
				param_list.find('li:not(:last) .remove-param').show();
				param_list.find('li:last .remove-param').hide();	
			}

			// bind events
			$('.param-list .remove-param').live('click', function(){
				$(this).parent().remove();
				return false;
			});
			$('.param-list .add-param').live('click', function(){
				addParam();
				return false;
			});
			
			addParam();
		})

		
	</script>
</body>
</html>

实例2

<ul id="movieList"></ul>

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

<script type="text/javascript">
    var movies = [
        { Name: "The Red Violin", ReleaseYear: "1998" },
        { Name: "Eyes Wide Shut", ReleaseYear: "1999" },
        { Name: "The Inheritance", ReleaseYear: "1976" }
    ];

    // Render the template with the movies data and insert
    // the rendered HTML under the "movieList" element
    $( "#movieTemplate" ).tmpl( movies )
        .appendTo( "#movieList" );
</script>

如果使用jquery1.9以上版本, 就不要使用.live()了,因为它以及被取消,所以使用下面代码on代替:

....


// bind events
$('.param-list').on('click','.remove-param', function(){
    $(this).parent().remove();
    return false;
});
$('.param-list').on('click','.add-param', function(){
    addParam();
    return false;
});
....

参考效果: DEMO  下载: jquery-tmpl-master

更多参考:

jQuery:从零开始,DIY一个jQuery(1)

jQuery:从零开始,DIY一个jQuery(2)

Comet 反Ajax: 基于jQuery与PHP实现Ajax长轮询(LongPoll)

jQuery: 插件开发模式详解 $.extend(), $.fn, $.widget()

jQuery: 选择器(DOM,name,属性,元素)

 

本文: jQuery .tmpl() 用法

One Comment

Leave a Reply