XTemplate

XTemplate是Extjs里面的模板组件.
下面我们看个最简单的例子.
效果图:

js代码:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)


-->Ext.onReady(function(){
//数据源
var data={
name:"博客园",
read:[{
book:'<<道不远人>>',
date:'2007-7-7'
},{
book:"<<大话设计模式>>",
date:"2006-6-6"
}]
}
//呈现组件
var mypanel=new Ext.Panel({
width:400,
id:"mypanel",
title:"XtemplateData简单示例",
renderTo:Ext.getBody()
});
//创建模板
var tpl=new Ext.XTemplate(
'<table><tr><th>名称:{name}</th></tr>',
'<tr><td>',
'<tpl for="read">',
'<p>编号:{#},书:{book},日期:{date}</p>',
'</tpl></td></tr></table>'
);
//重写绑定模板
tpl.overwrite(mypanel.body,data);
})
简要说明:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)


-->/*
var tpl=new Ext.XTemplate(
'<table><tr><th>名称:{name}</th></tr>',
'<tr><td>',
'<tpl for="read">',
'<p>编号:{#},书:{book},日期:{date}</p>',
'</tpl></td></tr></table>'
);
tpl.compile();
tpl.overwrite(mypanel.body,data);
*/
1.tpl.compile();//可以在创建模板后,添加tpl.compile();编译代码,速度快点.
2. tpl.overwrite(mypanel.body,data);//把数据填充到模板中去,并呈现到目标组件
3.名称:{name}//对于一维单数据对象,直接用{名称}输出,
4.,<tpl for="read">//对于多维对象(如拥有多条数据的表),使用tpl和for配合使用,会使用tpl的格式把数据一条一条输出,read为上级节点
5.{.}//对于一维对数据的对象,如color: ['Red', 'Blue', 'Black'],可以用{.}按照tpl模板逐一输出,如:
'<tpl for="color">',
'<div> {.}</div>',
'</tpl>'
6.{#}//表示循环的索引
7.parent.***//在子对象中访问父对象元素,使用parent,如:{parent.name}
8.if//'<tpl if="age > 1">',
'<p>{name}</p>',
'</tpl>',
//if实现有条件的逻辑判断,很容易使用
9.其他几个常用的参数:
xindex//循环模板的当前索引index（从1开始）,用[]。
xcount//循环模板循环的次数。 用[]
举例:
'<tpl for="read">',
'<p>编号:{#},书:{book},日期:{date},奇偶:{[xindex%2==0?"偶数":"奇数"]},次数:{[xcount]}</p>',
'</tpl>
10.模板成员函数(借用api下):
var tpl = new Ext.XTemplate(
'<tpl for="kids">',
'<tpl if="this.isGirl(name)">',
'<p>Girl: {name} - {age}</p>',
'</tpl>',
'<tpl if="this.isGirl(name) == false">',
'<p>Boy: {name} - {age}</p>',
'</tpl>',
'</tpl></p>', {
isGirl: function(name){
return name == 'Sara Grace';
},
isBaby: function(age){
return age < 1;
}
});
接下来,我们做个服务器的例子(好像很多朋友对这个要求很强烈啊)
实例演示:用模板呈现服务器数据
效果图:

html代码:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)


--><div id="container">
</div>
css代码:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)


--> <style type="text/css">
body
{
font-size:12px
}
#container
{
border:1px solid black;
width:330px;
}
td,th
{
border-bottom:1px dashed black;
}
th
{
text-align:center;
}
.namewidth
{
width:120px;
}
.urlwidth
{
width:150px;
}
</style>
js代码:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)


-->Ext.onReady(function(){


var mydata;
Ext.Ajax.request({
url:"getXtemplateData.ashx",//服务器端地址
success:function(request){
mydata=request.responseText;//服务器端文本数据
mydata=eval('('+mydata+')');//使用eval把文本数据转换为json对象
//或者用extjs自带的方法:mydata=Ext.util.JSON.decode(mydata),效果相同
var tpl2=new Ext.XTemplate(
'< table><thead><tr><th>编号</th><th class= "namewidth">名称</th><th class="urlwidth">地址</th>< th>位置</th></tr></thead><tbody>',
'<tpl for="results">',
'<tr><td>{#}</td><td>{linkname}</td><td>{linkurl}</td><td>{linkpos}</td><tr>',
'</tpl></tbody></table>'
);
tpl2.compile();
tpl2.overwrite(Ext.get("container"),mydata);

},
failure:function()
{
alert("failure!");
}
});
})

http://extjs.com/learn/Tutorial:Utilizing_Format_Features_of_Templates_(Chinese)

假设我们打算从一变量中，打印出内容，但当中的内容有可能会占用过多的空间。对于这种情况，通过的办法是对该内容截取，限制在50个英文字符内，然后做成连接让用户点击后观察全文。函数"ellipsis" 的功能正是这样，可限制在任意字符数内。另外，在截取字符串的后面，该函数还会加上“...“，以示实际的内容还有更多。

一个模板如下示

var myTpl = new Ext.Template(
'<div>{content:ellipsis(50)}<br/><a href="{moreLink}">Read More</a></div>'
);

通过处理，其中有47个字符是属于内容本身的，另外三个字符是”...“,一共50个字符。

这是一份可用于模板格式化函数的列表：

* ellipsis(length) - 对大于指定长度部分的字符串，进行裁剪，增加省略号（“...”）的显示。适用于只显示前N位的字符，然后提供详细页面的链接。
* undef -检查一个值是否为underfined，如果是的转换为空值
* htmlEncode - 转换(&, <, >, and ') 字符
* trim - 对一段文本的前后多余的空格裁剪
* substr(start, length) - 返回一个从指定位置开始的指定长度的子字符串。
* lowercase - 返回一个字符串，该字符串中的字母被转换为小写字母。
* uppercase - 返回一个字符串，该字符串中的字母被转换为大写字母。
* capitalize - 返回一个字符串，该字符串中的第一个字母转化为大写字母，剩余的为小写。
* usMoney - 格式化数字到美元货币。如：$10.97
* date[(format)] - 将一个日期解析成为一个特定格式模式的日期。如日期字符串不输入，默认为“月/日/年”
* stripTags - 剥去变量的所有HTML标签

您亦可以创建自定义的格式化函数，具体做法是，在模板的实例上加入新的方法，继而在模板上调用，格式化的函数应该像这样的：{VARIABLE:this.<formatfunction></formatfunction>}"

这是一个简单的实例，对模板实例加入一个"parseJson "的新函数。
Js代码

1. var tplFun = new Ext.Template(
2. '<table border=1 cellpadding=0 cellspacing = 0>',
3. '<tr><td width=90 >姓名</td>',
4. '<td width=120>{name}</td></tr>',
5. '<tr><td width=90 >年龄</td>',
6. '<td width=120>{age}</td></tr>',
7. '<tr><td width=90 >身高</td>',
8. '<td width=120>{stature:this.parseJson()}</td></tr>',
9. '</table>'
10. );
11. var data = {
12. name : 'tom',
13. age : 24,
14. stature : {
15. num : 170,
16. unit : '厘米'
17. }
18. }
19.
20. tplFun.parseJson = function(json){
21. return json.num + json.unit;
22. }
23. tplFun.append('tpl-table',data);