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


相关推荐

  • tar 解压命令

    tar 解压命令

    tar 解压命令

    全栈程序员-站长的头像 全栈程序员-站长
    2021年9月10日
    51
  • oracle 中decode函数[通俗易懂]

    oracle 中decode函数[通俗易懂]

    oracle 中decode函数[通俗易懂]Oracle中decode函数用法含义解释：decode(条件,值1,返回值1,值2,返回值2,…值n,返回值n,缺省值)该函数的含义如下：IF条件=值1THEN　　　　RETURN(翻译值1)ELSIF条件=值2THEN　　　　RETURN(翻译值2)　　　　…ELSIF条件=值nTHEN　　　　RETURN(翻译值n)ELSE　　　　RETURN(缺省…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年7月25日
    7
  • HikariPool 连接池问题

    HikariPool 连接池问题

    HikariPool 连接池问题前言：今天在一个项目运行的时候发现一个很奇怪的问题，当我有一段时间无操作之后再进行操作的话，就会出现HikariPool相关的报错，在此记录一下问题2022-02-2013:14:04.178WARN4012—[nio-8888-exec-6]com.zaxxer.hikari.pool.PoolBase:HikariPool-1-Failedtovalidateconnectioncom.mysql.cj.jdbc.ConnectionImpl@.

    全栈程序员-站长的头像 全栈程序员-站长
    2022年6月23日
    32
  • 基于matlab的图像处理案例教程_matlab gui图像处理

    基于matlab的图像处理案例教程_matlab gui图像处理

    基于matlab的图像处理案例教程_matlab gui图像处理一、imfinfo函数——查看图像文件信息，注意参数是文件路径和文件名，不是图像对应的矩阵。imfinfo(‘C:\Users\zhulf\Desktop\1.jpg’)ans=Filename:’C:\Users\zhulf\Desktop\1.jpg’FileModDate:’19-Apr-201508:40:54′

    全栈程序员-站长的头像 全栈程序员-站长
    2022年10月4日
    2
  • python批量修改文件名代码_python批量修改文件名的实现代码

    python批量修改文件名代码_python批量修改文件名的实现代码

    python批量修改文件名代码_python批量修改文件名的实现代码coding utf 8 批量修改文件名 importosimpo st r d s d 用于匹配旧的文件名 需含分组 re match old file name re compile re st 要修改的目录 WORKING PATH r F Gallery

    全栈程序员-站长的头像 全栈程序员-站长
    2025年8月19日
    0
  • 免费开放接口API

    免费开放接口API

    免费开放接口API为了方便各类开发者，现提供免费开放Api接口，所有接口均无使用限制，返回格式全是JSON，所以基本能满足大家的开发需求，但请各位不要将这些Api接入正式项目，因为有一些不稳定因素，目前服务器购买时长是三年，如果到期，我会自动续费，这些Api是我平时业余时间编写，可能有些不能满足需求的情况，请大家在留言区提出来，或者大家写Demo需要一些有关联的数据等等，都可以在留言区告诉我，我有时间一定会给大家处…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年5月24日
    204

发表回复

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

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