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 &gt; 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);