1. 全栈程序员必看首页

jQuery 模板 tmpl 用法「建议收藏」

全栈程序员-站长 • • 未分类 • 阅读 34

jQuery 模板 tmpl 用法「建议收藏」昨晚无意中发现一个有趣的jQuery插件.tmpl()，其文档在这里。官方解释对该插件的说明：将匹配的第一个元素作为模板，render指定的数据，签名如下:.tmpl([data,][options])其中参数data的用途很明显：用于render的数据，可以是任意js类型，包括数组和对象。options一般情况下都是

大家好，又见面了，我是你们的朋友全栈君。

昨晚无意中发现一个有趣的jQuery插件.tmpl()，其文档在这里。

官方解释对该插件的说明：将匹配的第一个元素作为模板，render指定的数据，签名如下:

.tmpl([data,][options])

其中参数data的用途很明显：用于render的数据，可以是任意js类型，包括数组和对象。options一般情况下都是选项了，官方指出，此处的options是一个用户自定义的键值对的map，继承自tmplItem数据结构，适用于模板render动作期间。

在这里可以下载到最新的tmpl插件，值的一提的是，官方同时也说明了，tmpl目前是beta版，使用需谨慎..

好吧，先来一个最直观的例子：

<%@ 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
>

jQuery 模板 tmpl 用法「建议收藏」

例子虽然很小也很简单，但我觉得这个已经很有用了。

当然，.tmpl()还可以使用来自远端的数据，比如说服务:

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;
}

这是一个MVC的Action，我把它当做是一个提供数据的服务，然后js代码如下:

$(
'#btnAjax'
).click(
function 
() {
    
$.getJSON(
'@Url.Action("SampleData", "Home")'
,
function 
(json) {
        
$(
'#rows'
).empty();
        
$(
'#myTemplate'
).tmpl(json).appendTo(
'#rows'
);
    
});
});

效果:

jQuery 模板 tmpl 用法「建议收藏」

定义模板时，推荐的方式为定义使用

<script id=
'templateName'  
type=
'text/x-jquery-tmpl'
></script>

做为模板的包装器，但定义方式并不只有这一种，你可以使用

<
div 
id="template" style="display: none;">
<!-- markup -->
</
div
>

的方式来定义，但是官方文档中说，这种方法可能会产生浏览器无法解析的HTML，因此不推荐使用，不过我试了下，倒没有出什么意外：

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 用法「建议收藏」

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

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>

效果:

jQuery 模板 tmpl 用法「建议收藏」

$.template()方法，将一段Html编译为模板，示例:

Javascript

var 
markup =
'<tr><td>${ID}</td><td>${Name}</td></tr>'
;
$.template(
'template'
, markup);
$.tmpl(
'template'
, users).appendTo(
'#templateRows'
);

这样就可以将markup中定义的模板应用于templateRows对象。

jQuery .tmpl()的标签，表达式，属性：

${}:从前面的例子来看，这个标签的作用很明显了，相当于是占位符，但是它还有另一种写法{
{= field}}如:

<
script 
id="myTemplate" type="text/x-jquery-tmpl">
    
<
tr
><
td
>{
{= ID}}</
td
><
td
>{
{= Name}}</
td
></
tr
>
</
script
>

必须要注意的是，”=”号后必须跟一个空格，不然是没有效果的。

另外，${}中还可以放表达式，这个牛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 用法「建议收藏」

jQuery .tmpl()有两个比较有用的属性:$item、$data:

$item代表当前的模板；$data代表当前的数据。

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>

效果:

jQuery 模板 tmpl 用法「建议收藏」

{
{each}}这个标签一看就知道是做循环用的了，用法如下：

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'
);
    
});

效果:

jQuery 模板 tmpl 用法「建议收藏」

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

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}}，这两个标签应该一看就知道作用了，直接上示例:

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数组元素超过1个，则用’; ‘连接起来，否则就直接显示Langs，效果:

jQuery 模板 tmpl 用法「建议收藏」

{
{html}}，直接将对象属性值作为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>

效果:

jQuery 模板 tmpl 用法「建议收藏」

{
{tmpl}}，前面已经提过该标签了，这里再给一个使用参数的例子:

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>

效果:

jQuery 模板 tmpl 用法「建议收藏」

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

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>

效果:

jQuery 模板 tmpl 用法「建议收藏」

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

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

效果:

jQuery 模板 tmpl 用法「建议收藏」

至此，官方的API中介绍的内容就完了，我的E文水平不高，对于某些细节难免理解不周，如有谬误之处，敬请指正，谢谢。

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。

发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/150085.html原文链接：https://javaforall.net

赞 (0)
全栈程序员-站长的头像全栈程序员-站长
0 0


相关推荐

  • 磁盘分区类型和分区表的区别[通俗易懂]

    磁盘分区类型和分区表的区别[通俗易懂]

    磁盘分区类型和分区表的区别[通俗易懂]任务1罗列磁盘分区的类型并做比较性介绍分类:FAT16、FAT32、NTFS、EXT2、EXT3、EXT4FAT16:磁盘分区最大只能到2GB、使用簇的大小不恰当、FAT16使用了16位的空间来表示每个扇区文件名长度有限制FAT32:相比FAT16会拥有更多的簇，更大空间容量上限为16TB根目录区（ROOT区）不再是固定区域、固定大小速度和FAT16一样快，对大磁盘利用率比FAT16好文件名长度有限制NTFS:备3个功能：错误预警功能、磁盘自我修复功能和日志功能安全性，

    全栈程序员-站长的头像 全栈程序员-站长
    2022年8月11日
    13
  • .net core开发工具_github 爬虫

    .net core开发工具_github 爬虫

    .net core开发工具_github 爬虫没有爬虫就没有互联网！爬虫的意义在于采集大批量数据，然后基于此进行加工/分析，做更有意义的事情。谷歌，百度，今日头条，天眼查都离不开爬虫。去开源中国和Github查询C#的爬虫项目，仅有…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年9月14日
    2
  • Excel VBA编程教程（基础一）

    Excel VBA编程教程（基础一）

    Excel VBA编程教程（基础一）VBA介绍VisualBasicforApplications（VBA）是VisualBasic的一种宏语言，是微软开发出来在其桌面应用程序中执行通用的自动化(OLE)任务的编程语言。主要能用来扩展Windows的应用程序功能，特别是MicrosoftOffice软件。说简单点，VBA是运行在MicrosoftOffice软件之上，可以用来编写非软件自带的功能的编程语言。Office软件提供丰富的功能接口，VBA可以调用它们，实现自定义的需求。基本上，能用鼠标和键盘能做的

    全栈程序员-站长的头像 全栈程序员-站长
    2022年4月29日
    2.1K
  • 计算机键盘win键,win10键盘win键失灵怎么办_电脑win10win键没反应的解决方法

    计算机键盘win键,win10键盘win键失灵怎么办_电脑win10win键没反应的解决方法

    计算机键盘win键,win10键盘win键失灵怎么办_电脑win10win键没反应的解决方法最近有朋友问小编win10键盘win键失灵怎么办，对于win10系统win键突然不能用的问题，相信很多朋友遇到过。有的朋友在升级完win10系统之后发现win10键盘win键失灵了，按下win键没反应，那么当我们遇到这种问题应该如何解决呢？别着急，小编这就为大家带来电脑win10win键没反应的解决方法。电脑win10win键没反应的解决方法：1、在Windows10系统桌面，右键点击任务栏的空白…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年6月4日
    45
  • SAP WebIDE里OData service catalog的实现原理「建议收藏」

    SAP WebIDE里OData service catalog的实现原理「建议收藏」

    SAP WebIDE里OData service catalog的实现原理「建议收藏」我们在SAPWebIDE里创建UI5应用时，可以从Servicecatalog里选择需要的OData服务，如下图所示：这个ag3-backend是什么意思？是我在SAPCloudPlatform的Destination标签页里维护的一个Destination：这个destination指向了一个OnpremiseABAPNetweaver系统，AG3，通过SAPCloud…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年10月18日
    3
  • python opencv入门 光流法（41）

    python opencv入门 光流法（41）

    python opencv入门 光流法（41）内容来自OpenCV-PythonTutorials自己翻译整理目标：了解光流的概念，使用lucas-kanade估算方法使用cv2.calcOpticalFlowPyrLK()方法来追踪视频中的特征点光流：光流的概念是指在连续的两帧图像当中，由于图像中的物体移动或者摄像头的移动而使得图像中的目标的运动叫做光流。（说简单点，考虑摄像头不会动的情况，就是一个视频当中有一个…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年7月23日
    17

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号