全面解析Ext模板XTemplate(转)


自动填充数组;

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

子模板;

支持基本的方法匹配;

特殊的内置模板参数;

执行内嵌的代码,

等等。

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

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

var data = {

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

title: ' Ext 首席开发者 ',

    company: 'Ext JS, LLC',

    email: '[email protected]',

    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、 自动填充数组并切换作用域

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Title: {title}

',

    '

Company: {company}

',

    '

Kids: ',

    '',

        '

{name}

',

    '

'

);

tpl.overwrite(panel.body, data);

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

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Kids: ',

    '',

        '',

            '

{name}

',

             '

Dad: {parent.name}

',

        '',

    '

'

);

tpl.overwrite(panel.body, data);

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

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Kids: ',

    '',

        '',

            '

{#}: {name}

', // <-- Auto-number each item

            '

In 5 Years: {age+5}

', // <-- Basic math

            '

Dad: {parent.name}

',

        '',

    '

'

);

tpl.overwrite(panel.body, data);

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

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

var tpl = new Ext.XTemplate(

    '

{name}\'s favorite beverages:

',

    '',

       '

- {.}
',

    ''

);

tpl.overwrite(panel.body, data);

5、 基本的条件匹配逻辑

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Kids: ',

    '',

       '',// ß 注意: ”>” 号是编码好的。

            '

{name}

',

        '',

    '

'

);

tpl.overwrite(panel.body, data);

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

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

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

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

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

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

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Company: {[values.company.toUpperCase() + ", " + values.title]}

',

    '

Kids: ',

    '',

       '

',

        '{name}',

        '

',

    '

'

);

tpl.overwrite(panel.body, data);

7、 模板的成员函数

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

var tpl = new Ext.XTemplate(

    '

Name: {name}

',

    '

Kids: ',

    '',

        '',

            '

Girl: {name} - {age}

',

        '',

        '',

            '

Boy: {name} - {age}

',

        '',

        '',

            '

{name} is a baby!

',

       '',

    '

', {

     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.}" 

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

   1. var tplFun = new Ext.Template( 
   2.             '

', 
   3.             '
', 
   4.             '
', 
   5.             '
', 
   6.             '
', 
   7.             '
', 
   8.             '
', 
   9.             '
姓名{name}
年龄{age}
身高{stature:this.parseJson()}

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

你可能感兴趣的:(转载。不灭de记忆)