符号 | 含义 | 表示 | 示例 |
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)}
所有评论仅代表网友意见