现在的位置: 首页 > 综合 > 正文

全面解析Ext模板XTemplate(转)

2014年09月08日 ⁄ 综合 ⁄ 共 4953字 ⁄ 字号 评论关闭


自动填充数组;

按照基本的比较运算符进行条件过滤;

子模板;

支持基本的方法匹配;

特殊的内置模板参数;

执行内嵌的代码,

等等。

         模板也提供一种模式化的机制使它成为 Ext.DataView 的组件。

         模板支持很多特殊的标签和内置的操作符,这些没有被作为 API 的一部分来定义,但是可以作为模板的一部分来创建。以下的例子演示了所有支持的特性。下面是一个数据对象,每段示例代码都使用这个对象。

var data = {

name: ' 杰克 . 斯洛克姆 ',

title: ' Ext 首席开发者 ',

    company: 'Ext JS, LLC',

    email: 'jack@extjs.com',

    address: '4 Red Bulls Drive',

    city: 'Cleveland',

    state: 'Ohio',

    zip: '44102',

    drinks: ['Red Bull', 'Coffee', 'Water'],

kids: [

{

        name: 'Sara Grace',

        age:3

    },{

        name: 'Zachary',

        age:2

    },{

        name: 'John James',

        age:0

}

]

};

1、 自动填充数组并切换作用域

使用 ”<tpl>” 标签和 ”for” 操作符,你可以把作用域切换到 ”for” 所指向的对象,然后访问这个对象的成员来组装模板。如果 ”for” 循环中的变量是一个数组,它将被自动填充,对于数组中的每个元素,重复 ”<tpl>” 标签中的模板 ( 定义 ) 块 ( 来自动填充 ) 。(译者注:这句的意思是,如果 for 循环里面指定的对象是个数组,就会自动解析这个数组,然后使用数组中的每个元素来填充模板。)

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Title: {title}</p>',

    '<p>Company: {company}</p>',

    '<p>Kids: ',

    '<tpl for="kids">',

        '<p>{name}</p>',

    '</tpl></p>'

);

tpl.overwrite(panel.body, data);

2、 从内部的子模板作用域访问父对象

当处理一个子模板时,例如当迭代 ”child” 这个数组的时候,你可以通过 ”parent” 关键字来访问父对象的成员。

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Kids: ',

    '<tpl for="kids">',

        '<tpl if="age > 1">',

            '<p>{name}</p>',

             '<p>Dad: {parent.name}</p>',

        '</tpl>',

    '</tpl></p>'

);

tpl.overwrite(panel.body, data);

3、 数组元素序号和基本的匹配支持

当处理数组的时候,特殊的变量 ”{#}” 可以提供数组当前的 index+1 (这个数据)。模板也支持基本的数学运算符 ”+” 、 ”-” 、 ”*” 、 ”/” ,这些操作符可以直接在数字型的数据值上使用。

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Kids: ',

    '<tpl for="kids">',

        '<tpl if="age > 1">',

            '<p>{#}: {name}</p>', // <-- Auto-number each item

            '<p>In 5 Years: {age+5}</p>', // <-- Basic math

            '<p>Dad: {parent.name}</p>',

        '</tpl>',

    '</tpl></p>'

);

tpl.overwrite(panel.body, data);

4、 自动渲染普通的(译者注:数组元素不是对象,是基本的 String 、 Number )数组

普通的数组,包含的元素(不是对象型的)可以使用特殊的变量 ”{.}” 在一个循环体内自动渲染。这个变量用来描述数组当前索引中的值。

var tpl = new Ext.XTemplate(

    '<p>{name}\'s favorite beverages:</p>',

    '<tpl for="drinks">',

       '<div> - {.}</div>',

    '</tpl>'

);

tpl.overwrite(panel.body, data);

5、 基本的条件匹配逻辑

使用 ”<tpl>” 标签和 ”if” 操作符,你可以提供条件检查,来决定是否渲染模板中指定的部分。注意:没有 ”else” 操作符 --- 如果需要,你必须使用两个条件不同的 ”if” 。这里需要编码好的(译者注:意指 URL 转义字符 )符号,就像以下的示例一样 :

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Kids: ',

    '<tpl for="kids">',

       '<tpl if="age &gt; 1">',// ß 注意: ”>” 号是编码好的。

            '<p>{name}</p>',

        '</tpl>',

    '</tpl></p>'

);

tpl.overwrite(panel.body, data);

6、 执行任意内嵌代码的能力

在一个模板里面,位于 ”{[…]}” 号中的任何东西都被当作是需要在模板作用域内被执行的代码。在这段代码里面,有一些特殊的变量可以使用:

“ values ” :当前作用域下的值。如果你使用子模板来改变作用域,你就可以改变 ”values” 的值。

“ parent ” :“祖先”模板的作用域(或值)。

“ xindex ” :如果你在一个循环的模板里面,这个值表示你当前所在的“第几次”循环(从 1 开始)。

“ xcount ” :如果你在一个循环的模板里面,这个值表示你正在迭代的数组的总长度。

“ fm ” : Ext.util.Format 对象的别名。

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Company: {[values.company.toUpperCase() + ", " + values.title]}</p>',

    '<p>Kids: ',

    '<tpl for="kids">',

       '<div class="{[xindex % 2 === 0 ? "even" : "odd"]}">',

        '{name}',

        '</div>',

    '</tpl></p>'

);

tpl.overwrite(panel.body, data);

7、 模板的成员函数

可以在 config 对象中定义一个或多个成员函数传递给 XTemplate 的构造函数,来进行更复杂的处理。

var tpl = new Ext.XTemplate(

    '<p>Name: {name}</p>',

    '<p>Kids: ',

    '<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 if="this.isBaby(age)">',

            '<p>{name} is a baby!</p>',

       '</tpl>',

    '</tpl></p>', {

     isGirl: function(name){

         return name == 'Sara Grace';

     },

     isBaby: function(age){

        return age < 1;

     }

});

tpl.overwrite(panel.body, data);

通过处理,其中有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);


转自:http://hi.baidu.com/godghdai/item/fad6e0db3d315d19d68ed01d

抱歉!评论已关闭.