全面解析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