jQuery .tmpl(), .template()學(xué)習(xí)資料小結(jié)
昨晚無(wú)意中發(fā)現(xiàn)一個(gè)有趣的jQuery插件.tmpl(),其文檔在這里。官方解釋對(duì)該插件的說(shuō)明:將匹配的第一個(gè)元素作為模板,render指定的數(shù)據(jù),簽名如下:
.tmpl([data,][options]) |
其中參數(shù)data的用途很明顯:用于render的數(shù)據(jù),可以是任意js類型,包括數(shù)組和對(duì)象。options一般情況下都是選項(xiàng)了,官方指出,此處的options是一個(gè)用戶自定義的鍵值對(duì)的map,繼承自tmplItem數(shù)據(jù)結(jié)構(gòu),適用于模板render動(dòng)作期間。
在這里可以下載到最新的tmpl插件,值的一提的是,官方同時(shí)也說(shuō)明了,tmpl目前是beta版,使用需謹(jǐn)慎..
好吧,先來(lái)一個(gè)最直觀的例子:
<%@ Page Language="C#" AutoEventWireup="true" %>
<!DOCTYPE html>
<html>
<head>
<title>jquery template demo</title>
<link rel="stylesheet" href="content/site.css" type="text/css" />
<link rel="stylesheet" href="content/jquery.ui.css" type="text/css" />
<script type="text/javascript" src="scripts/jquery.js"></script>
<script type="text/javascript" src="scripts/jquery.ui.js"></script>
<script type="text/javascript" src="scripts/jquery.tmpl.js"></script>
<script id="myTemplate" type="text/x-jquery-tmpl">
<tr><td>${ID}</td><td>${Name}</td></tr>
</script>
<script type="text/javascript">
$(function () {
var users = [{ ID: 'think8848', Name: 'Joseph Chan' }, { ID: 'aCloud', Name: 'Mary Cheung'}];
$('#myTemplate').tmpl(users).appendTo('#rows');
});
</script>
<style type="text/css">
body
{
padding: 10px;
}
table
{
border-collapse: collapse;
}
</style>
</head>
<body>
<table cellspacing="0" cellpadding="3" border="1">
<tbody id="rows">
</tbody>
</table>
</body>
</html>
例子雖然很小也很簡(jiǎn)單,但我覺(jué)得這個(gè)已經(jīng)很有用了。
當(dāng)然,.tmpl()還可以使用來(lái)自遠(yuǎn)端的數(shù)據(jù),比如說(shuō)服務(wù):
public ActionResult SampleData()
{
var json = new JsonResult();
json.Data = new[] { new { ID = "remote1", Name = "abcd" }, new { ID = "remote2", Name = "efg" } };
json.JsonRequestBehavior = JsonRequestBehavior.AllowGet;
return json;
}
這是一個(gè)MVC的Action,我把它當(dāng)做是一個(gè)提供數(shù)據(jù)的服務(wù),然后js代碼如下:
$('#btnAjax').click(function () {
$.getJSON('@Url.Action("SampleData", "Home")', function (json) {
$('#rows').empty();
$('#myTemplate').tmpl(json).appendTo('#rows');
});
});
效果:
定義模板時(shí),推薦的方式為定義使用
<script id= 'templateName' type= 'text/x-jquery-tmpl' ></script> |
做為模板的包裝器,但定義方式并不只有這一種,你可以使用
< div id = "template" style = "display: none;" > <!-- markup --> </ div > |
的方式來(lái)定義,但是官方文檔中說(shuō),這種方法可能會(huì)產(chǎn)生瀏覽器無(wú)法解析的HTML,因此不推薦使用,不過(guò)我試了下,倒沒(méi)有出什么意外:
HTML:
<div id="container">
</div>
<div id="inline" style="display: none">
<label>
${ID}</label>
<label>
${Name}</label><br />
</div>
Javascript:
var users = [{ ID: 'think8848', Name: 'Joseph Chan' }, { ID: 'aCloud', Name: 'Mary Cheung'}];
$('#inline').tmpl(users).appendTo('#container');
效果:
編譯緩存模板,在jQuery .tmpl()中,還可以將模板事先編譯并緩存起來(lái),然后在合適的時(shí)侯再使用,這對(duì)于一些數(shù)據(jù)嵌套是很有用的,如:
Html
<table cellspacing="0" cellpadding="3" border="1">
<tbody id="compileRows">
</tbody>
</table>
Javascript
<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>
效果:
$.template()方法,將一段Html編譯為模板,示例:
Javascript
var markup = '<tr><td>${ID}</td><td>${Name}</td></tr>';
$.template('template', markup);
$.tmpl('template', users).appendTo('#templateRows');
這樣就可以將markup中定義的模板應(yīng)用于templateRows對(duì)象。
jQuery .tmpl()的標(biāo)簽,表達(dá)式,屬性:
${}:從前面的例子來(lái)看,這個(gè)標(biāo)簽的作用很明顯了,相當(dāng)于是占位符,但是它還有另一種寫(xiě)法{{= field}}如:
<script id="myTemplate" type="text/x-jquery-tmpl">
<tr><td>{{= ID}}</td><td>{{= Name}}</td></tr>
</script>
必須要注意的是,"="號(hào)后必須跟一個(gè)空格,不然是沒(méi)有效果的。
另外,${}中還可以放表達(dá)式,這個(gè)牛x吧,如:
Html
<table cellspacing="0" cellpadding="3" border="1">
<tbody id="expressionRows">
</tbody>
</table>
Javascript
<script type="text/javascript">
$(function () {
var userLangs = [{ ID: 'think8848', Name: 'Joseph Chan', Langs: ['Chinese', 'English'] }, { ID: 'aCloud', Name: 'Mary Cheung', Langs: ['Chinese', 'French']}];
$('#expression').tmpl(userLangs).appendTo('#expressionRows');
});
</script>
效果:
jQuery .tmpl()有兩個(gè)比較有用的屬性:$item、$data:
$item代表當(dāng)前的模板;$data代表當(dāng)前的數(shù)據(jù)。
Html
<table cellspacing="0" cellpadding="3" border="1">
<tbody id="propertyRows">
</tbody>
</table>
Javascript
<script id="property" type="text/x-jquery-tmpl">
<tr><td>${ID}</td><td>${$data.Name}</td><td>${$item.getLangs('; ')}</td></tr> </script>
<script type="text/javascript">
$(function () {
var userLangs = [{ ID: 'think8848', Name: 'Joseph Chan', Langs: ['Chinese', 'English'] }, { ID: 'aCloud', Name: 'Mary Cheung', Langs: ['Chinese', 'French']}];
$('#property').tmpl(userLangs, {
getLangs: function (separator) {
return this.data.Langs.join(separator);
}
})
.appendTo('#propertyRows');
});
</script>
效果:
{{each}}這個(gè)標(biāo)簽一看就知道是做循環(huán)用的了,用法如下:
Html
<ul id="eachList">
</ul>
Javascript
<script id="each" type="text/x-jquery-tmpl">
<li>ID: ${ID}; Name: ${Name};<br />Langs:<ul>{{each Langs}}<li>${$index + 1}: <label>${$value}. </label></li>{{/each}}<ul></li>
</script>
<script type="text/javascript">
$(function () {
var userLangs = [{ ID: 'think8848', Name: 'Joseph Chan', Langs: ['Chinese', 'English'] }, { ID: 'aCloud', Name: 'Mary Cheung', Langs: ['Chinese', 'French']}];
$('#each').tmpl(userLangs).appendTo('#eachList');
});
效果:
{{each}}還有另一種寫(xiě)法:
Javascript
<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> |
作用和前一種是一樣的。
{{if}}和{{else}},這兩個(gè)標(biāo)簽應(yīng)該一看就知道作用了,直接上示例:
Javascript
<script id= "ifelse" type= "text/x-jquery-tmpl" > |
<tr><td>${ID}</td><td>${Name}</td><td>{{ if Langs.length > 1}}${Langs.join( '; ' )}{{ else }}${Langs}{{/ if }}</td></tr> |
</script> |
如果Langs數(shù)組元素超過(guò)1個(gè),則用'; '連接起來(lái),否則就直接顯示Langs,效果:
{{html}},直接將對(duì)象屬性值作為HTML代碼替換占位符:
Javascript
<script id= "html" type= "text/x-jquery-tmpl" > |
<tr><td>${ID}</td><td>${Name}</td><td>{{html Ctrl}}</td></tr> |
</script> |
<script type= "text/javascript" > |
$( function () { |
var ctrls = [{ ID: 'think8848' , Name: 'Joseph Chan' , Ctrl: '<input type="button" value="Demo" />' }, { ID: 'aCloud' , Name: 'Mary Cheung' , Ctrl: '<input type="text" value="Demo" />' }]; |
$( '#html' ).tmpl(ctrls).appendTo( '#htmlRows' ); |
}); |
</script> |
效果:
{{tmpl}},前面已經(jīng)提過(guò)該標(biāo)簽了,這里再給一個(gè)使用參數(shù)的例子:
Javascript
<script id= "tmpl1" type= "text/x-jquery-tmpl" > |
<tr><td>${ID}</td><td>${Name}</td><td> {{tmpl($data) '#tmpl2' }}</td></tr> |
</script> |
<script id= "tmpl2" type= "type/x-jquery-tmpl" > |
{{each Langs}}${$value} {{/each}} |
</script> |
<script type= "text/javascript" > |
$( function () { |
var userLangs = [{ ID: 'think8848' , Name: 'Joseph Chan' , Langs: [ 'Chinese' , 'English' ] }, { ID: 'aCloud' , Name: 'Mary Cheung' , Langs: [ 'Chinese' , 'French' ]}]; |
$( '#tmpl1' ).tmpl(userLangs).appendTo( '#tmplRows' ); |
}); |
</script> |
效果:
{{wrap}},包裝器,這回不需要指定對(duì)哪一個(gè)元素使用模板了,直接生成模板的包裝器,示例:
Html
< div id = "wrapDemo" > |
</ div > |
Javascript
<script id= "myTmpl" type= "text/x-jquery-tmpl" > |
The following wraps and reorders some HTML content: |
{{wrap "#tableWrapper" }} |
<h3>One</h3> |
<div> |
First <b>content</b> |
</div> |
<h3>Two</h3> |
<div> |
And <em>more</em> <b>content</b>... |
</div> |
{{/wrap}} |
</script> |
<script id= "tableWrapper" type= "text/x-jquery-tmpl" > |
<table cellspacing= "0" cellpadding= "3" border= "1" ><tbody> |
<tr> |
{{each $item.html( "h3" , true )}} |
<td> |
${$value} |
</td> |
{{/each}} |
</tr> |
<tr> |
{{each $item.html( "div" )}} |
<td> |
{{html $value}} |
</td> |
{{/each}} |
</tr> |
</tbody></table> |
</script> |
<script type= "text/javascript" > |
$( function () { |
$( '#myTmpl' ).tmpl().appendTo( '#wrapDemo' ); |
}); |
</script> |
效果:
$.tmplItem()方法,使用這個(gè)方法,可以獲取從render出來(lái)的元素上重新獲取$item,示例:
$( 'tbody' ).delegate( 'tr' , 'click' , function () { |
var item = $.tmplItem( this ); |
alert(item.data.Name); |
}); |
效果:
至此,官方的API中介紹的內(nèi)容就完了,我的E文水平不高,對(duì)于某些細(xì)節(jié)難免理解不周,如有謬誤之處,敬請(qǐng)指正,謝謝。
源代碼下載
- JQuery實(shí)現(xiàn)的在新窗口打開(kāi)鏈接的方法小結(jié)
- jQuery CheckBox全選、全不選實(shí)現(xiàn)代碼小結(jié)
- jQuery Selector選擇器小結(jié)
- jQuery select操作控制方法小結(jié)
- jQuery中調(diào)用WebService方法小結(jié)
- jquery中獲取元素的幾種方式小結(jié)
- 淺析jQuery對(duì)select操作小結(jié)(遍歷option,操作option)
- jquery中獲取id值方法小結(jié)
- Jquery中ajax方法data參數(shù)的用法小結(jié)
- jquery中的$(document).ready()使用小結(jié)
- jquerymobile局部渲染的各種刷新方法小結(jié)
- 利用jquery操作Radio方法小結(jié)
- jquery使用經(jīng)驗(yàn)小結(jié)
相關(guān)文章
基于Jquery 解決Ajax請(qǐng)求的頁(yè)面 瀏覽器后退前進(jìn)功能,頁(yè)面刷新功能實(shí)效問(wèn)題
做了幾個(gè)兼職,上天幫人完成頁(yè)面的時(shí)候順便做了一個(gè)ajax的請(qǐng)求。發(fā)現(xiàn)瀏覽器的刷新,后退,前進(jìn)按鈕失效。于是乎google了一下。2010-12-12通過(guò)jQuery源碼學(xué)習(xí)javascript(三)
承接上兩篇繼續(xù)寫(xiě)下去。我盡量把我明白的地方給大家說(shuō)清楚。有些大家的提問(wèn)我也有點(diǎn)搞不明白,如果有人能解答,再好不過(guò)了2012-12-12jQuery實(shí)現(xiàn)獲取當(dāng)前鼠標(biāo)位置并輸出功能示例
這篇文章主要介紹了jQuery實(shí)現(xiàn)獲取當(dāng)前鼠標(biāo)位置并輸出功能,涉及jQuery事件響應(yīng)及頁(yè)面元素屬性動(dòng)態(tài)操作相關(guān)實(shí)現(xiàn)技巧,需要的朋友可以參考下2019-01-01JQUERY 獲取IFrame中對(duì)象及獲取其父窗口中對(duì)象示例
經(jīng)常會(huì)用到iframe,難免會(huì)碰到需要在父窗口中使用iframe中的元素、或者在iframe框架中使用父窗口的元素,下面為大家簡(jiǎn)單介紹下本人的使用心得2013-08-08jQuery zTree樹(shù)插件動(dòng)態(tài)加載實(shí)例代碼
這篇文章主要介紹了jQuery zTree樹(shù)插件動(dòng)態(tài)加載效果的實(shí)例代碼,需要的朋友可以參考下2017-05-05jQuery插件zTree實(shí)現(xiàn)獲取當(dāng)前選中節(jié)點(diǎn)在同級(jí)節(jié)點(diǎn)中序號(hào)的方法
這篇文章主要介紹了jQuery插件zTree實(shí)現(xiàn)獲取當(dāng)前選中節(jié)點(diǎn)在同級(jí)節(jié)點(diǎn)中序號(hào)的方法,結(jié)合實(shí)例形式分析了屬性插件zTree針對(duì)節(jié)點(diǎn)序號(hào)的相關(guān)操作技巧,需要的朋友可以參考下2017-03-03JQuery特殊效果和鏈?zhǔn)秸{(diào)用操作示例
這篇文章主要介紹了JQuery特殊效果和鏈?zhǔn)秸{(diào)用操作,結(jié)合實(shí)例形式分析總結(jié)了jQuery各種常見(jiàn)顯示效果與所使用的函數(shù),以及鏈?zhǔn)秸{(diào)用顯示層級(jí)菜單功能相關(guān)操作技巧,需要的朋友可以參考下2019-05-05