1. 1. format 格式化函数

1. 1.1. 日期格式

在制作模板过程中,如遇到是日期类型的字段可以通过调用format函数的方式格式化日期显示。如:

${format(Article.PublishDate,'yyyy-MM-dd')},则会将文章发布日期输出成类似于2012-01-01的格式。

日期格式:

符号

含义

表示

示例

G

年代标志符              

(Text)            

AD

y

年                    

(Number)          

1996

M

月                    

(Text & Number)    

July & 07

d

日                    

(Number)          

10

h

时 在上午或下午 (1~12)

(Number)          

12

H

时 在一天中 (0~23)    

(Number)          

0

m

分                    

(Number)          

30

s

秒                    

((Number)          

55

S

毫秒                  

((Number)          

978

E

星期                  

(Text)            

Tuesday

D

一年中的第几天        

(Number)          

189

F

一月中第几个星期几    

(Number)          

2 (2nd Wed in July)

w

一年中第几个星期      

(Number)          

27

W

一月中第几个星期      

(Number)          

2

a

上午 / 下午 标记符    

(Text)            

PM

k

时 在一天中 (1~24)    

(Number)          

24

K

时 在上午或下午 (0~11)

(Number)          

0

1. 1.2. 数字格式

如字段类型为number,则可以设置数字格式,如${format(Article.Price,'##.##')}表示保留2为小数。

1. 2. ClearHtmlTag 清除HTML函数

在制作模板过程中,如遇到是html内容的字段可以通过调用clearHtml的方式清理html中的标签后显示。

例如:${clearHtmlTag(Article.Content)}。

取非全部内容时:先清除HTML标签后截取

${charWidth(clearHtmlTag(Article.content), 50,"...")}

1. 3. CharWidth 字符截取函数

如遇到是文字内容的长度太长,可以调用charWidth函数截取指定长度的文字后显示。如:

${charWidth(Article.Title, n)},或者${charWidth(Article.Title, n,"……")},会将文章标题n-2个位宽之后的部分截掉(一个汉字占2个位宽,一个英文字母占1个位宽),第三个参数指定截取后添加的后缀,默认为“…”。

1. 4. Replace 文本替换函数

如:把”../”换成””

直接使用替换全部所匹配的字符

${replace(catalog.link,"../","")}

使用正则方式替换所匹配的字符

${replace(catalog.link,"\\.\\.\\/","","regex")}

参数1:待处理字符串;

参数2:需要替换的字符串;

参数3:替换的字符串,默认为空;

参数4:替换模式,不设置默认为字符串替换,设为regex表示使用正则替换。

1. 5. ImageSize 图片大小函数

指定图片大小,如:

${ImageSize(Artile.LogoFile,120,90)},会将图片自动缩放到指定尺寸,如果该尺寸的图片缩略图已经存在,则直接使用己存在的缩略图。其中第一个参数Article.LogoFile的地址为相对站点目录的地址。

支持4个参数:1.图片链接、2.缩放宽度、3.缩放高度、4.缩放模式-非必须默认为fill(fill-填充,fit-适应)

示例:${ImageSize(Article.LogoFile,128,128,'fill')}

1. 6. AdvanceImageSize 图片大小函数

本方法将通过注册相同扩展ID的方式覆盖掉内容核心中的ImageSizeFunction,以增加发布点的支持。如:

${AdvanceImageSize(Artile.LogoFile,120,90)}

1. 7. Contains 包含函数

判断一个字符是否包含有另一个字符,如:

${contains(Artile.Title,'A')}。

返回TRUE或FALSE

1. 8. ContainsIgnoreCase 不区分大小写包含函数

判断一个字符是否包含有另一个字符,不区分字符的大小写,如:

${ContainsIgnoreCase(Artile.Title,'a')}。

返回-1或字符所在索引值(下标)

1. 9. EndsWith 字符串结束函数

判断字符串是否有指定的后缀,如:

${endsWith(Artile.Title,'项目')}。

返回TRUE或FALSE

1. 10. StartsWith 字符串开始函数

判断字符串是否有指定的前缀,如:

${StartsWith(Artile.Title,'2012')}。

返回TRUE或FALSE

1. 11. EscapeJson JSON输出函数

将一段JSON编码后输出,如:

${escapeJson(Artile.Content)}。

1. 12. EscapeXml XML输出函数

将一段XML编码后输出,如:

${escapeXml(Artile.Content)}。

1. 13. IndexOf 字符串查找函数

查找一个字符串在哪一个字符串中的位置,如:

${indexOf(Artile.Content,'项目')}。

常用判断:(文章分类属性含有图片的)

<z:if condition=”${indexOf(Article.AttributeStr,'image')!= -1}”>[图片]</z:if>

返回-1或字符所在索引值(下标)

1. 14. Join 字符串数组拼接函数

将一个字输串数组以指定的分隔符拼接后输出,如:

${join(Data.Names,',')}。

1. 15. Length 长度函数

计算字符串、数组或者集合的长度,如:

${length(Artile.Content)}。

1. 16. Split 字符串分隔函数

将一个字符串以指定的分隔符分隔成数组,如:

${split(Artile.Content,'\n')}。

1. 17. Substring 字符串截取函数

将一个字符串按位置截取,如:

${substring(Artile.Content,3)};

从第3个字符开始截取,

${substring(Artile.Content,3,10)},

截取第3至10个字符。

1. 18. SubstringAfter 字符串截取函数

从指定字符串结束的位置开始截取,如果原字符串不包含指定字符串,则返回原字符串,如:

${substringAfter(Artile.Content,'项目')}。

1. 19. SubstringBefore 字符串截取函数

从第一个字符串开始截取,直到指定字符串开始的位置,如果原字符串不包含指定字符串,则返回原字符串,如:

${substringBefore(Artile.Content,'项目')}。

1. 20. TolowerCase 小写函数

将一个字符串中的全部字符串都转换成小型,如:

${toLowerCase(Artile.Title)}。

1. 21. ToUpperCase 大写函数

将一个字符串中的全部字符串都转换成大型,如:

${toUpperCase(Artile.Title)}。

1. 22. Trim 清除空白函数

将一个字符串前后的空白字符清除掉,如:

${trim(Artile.Title)}。

1. 23. Trim2 清除包含全角空白函数

清除掉字符串前后的空格,包括全角空格。如:

${trim2(Artile.Title)}。

1. 24. Text2Image 文字转图函数

将一段文本转成图片,返回图片相对于站点根目录的地址(包含文件名)。如:

${text2image(Article.BodyText)}。

参数1:文字内容;

参数2:fontfamily,默认为宋体;

参数3:fontstyle;

参数4:fontsize;

参数5:字体颜色,默认为“#000”;

参数6:图片背景色,默认为“#fff”;

参数7:图片存放路径,相对于站点根目录。

1. 26. BrowsePriv 判断文章浏览权限函数

判断浏览权限。

如:${BrowsePriv(Article.ID)}

1. 27. Catalog 取栏目数据函数

取栏目数据的函数,用来取代1.x中在脚本块中的CatalogUtil.getName()系列方法。

注意:

1、 默认要求第一个参数传入ID;

2、 如果第一个参数传入的是别名,则需要第二次参数为'Alias';

3、 如果第一个参数传入的是内部编码,则需要第二次参数为'InnerCode';

4、 取到数据是ZCCatalog实例;

如:${Catalog(Catalog.ID).Name}

1. 28. Eval执行包含表达式函数

在JS脚本中执行一段含有表达式的字符串。如:

${Eval(str)}

1. 29. JavaEncode 字符串Java转码函数

对字符串进行java转码,以便于在javascript中输出成字符串。如:

${JavaEncode('*?|"32*')}

1. 30. Match 正则表达式匹配函数

第一个参数是否正则匹配第二个参数。如:

${Match("xx@163.com","\\w+([\\-+.]\\w+)*@\\w+([\\-.]\\w+)*\\.\\w+([\\-.]\\w+)*")}

1. 31. Now 返回当前时间函数

返回表示当前时间的Date对象。如:

${now().time}返回毫秒数,${format(now(),'yyyy-MM-dd')}返回当前日期。

1. 32. ParseInt 转为整型函数

将指定对象转换为整型。如:

${ParseInt(1.2)}

1. 33. Prefix 处理模板资源前缀函数

处理模板资源前缀的函数。如:

<img src="${Prefix}${ImageSize(Article.LogoFile,128,128)}" alt="${Article.Title}" />

1. 34. SourceImage 取原图函数

取原图的函数,会将图片路径包含中形如“_120x120”的尺寸后缀去掉。如:

${SourceImage(Article.LogoFile)}

1. 35. UrlEncode Url转码函数

对字符串进行Url转码,以便于在Url中输出成字符串。如:

${UrlEncode(Site.Url)}