Ext template

Summary 摘要：如何利用模板（Templates）的格式化功能和加入您自定义格式的函数

Author: Aaron Conran
Translater: Frank Cheung
Published: May 16, 2007

本教程基于Ext的模板引擎展开详述，亦是对 Shea Frederick“”教程一文的补充。假设读者已经初步接触过模板（Templates）,和格式化函数的基本语法为“{VARIABLE:[(可选的参数)]}”。

正式开始

假设我们打算从一变量中， 打印出内容，但当中的内容有可能会占用过多的空间。对于这种情况，通过的办法是对该内容截取，限制在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.}"

这是一个简单是实例，对模板实例加入一个"yesNoFormat "的新函数。yesNoFormat 与ColdFusion转换”truthy“函数相类似 ，如果是真的输出"Yes",假的输出”No“。

var testCustomTpl = new Ext.Template('<div>User: {username} IsRevoked: {revoked:this.yesNoFormat}</div>');
testCustomTpl.yesNoFormat = function(value) {
	return value ? 'Yes' : 'No';
};		
testCustomTpl.append(document.body, {username: 'aconran', revoked: 1});