Ext JS - Learning Center

Tutorial:Utilizing Format Features of Templates (Chinese)

From Learn About the Ext JavaScript Library

Jump to: navigation, search
Summary: 如何利用模板(Templates)的格式化功能和加入您自定义格式的函数
Author: Aaron Conran(译者:Frank Cheung)
Published: 2007六月十日
Ext Version: 1.1
Languages: en.png English cn.png Chinese

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

正式开始

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

这是一个简单的实例,对模板实例加入一个"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});

下一步

关于怎么学好EXT这个框架我的看法是,在您熟悉的IDE中打开源码进行阅读。保证阁下一定会收获不少技巧和写代码的好习惯,而且极有可能发现新的大陆,还是没有归档的。熟悉模板Templates的简单用法和格式化功能后,就可进入下一步的学习:MasterTemplates。MasterTemplates提供了处理”子模板“的功能,以方便从数据库循环数据,同时亦包含模板(Templates)的所有功能。

  • This page was last modified 13:10, 27 October 2008.
  • This page has been accessed 12,615 times.