# <stl:value> 获取值
<stl:value
type="类型"
format="显示的格式"
wordNum="显示字符的数目"
startIndex="字符开始位置"
length="指定字符长度"
ellipsis="文字超出部分显示的文字"
replace="需要被替换的文字"
to="替换文字"
isClearTags="清除标签"
isReturnToBr="回车改为换行"
isLower="转换为小写"
isUpper="转换为大写"
leftText="显示在信息前的文字"
rightText="显示在信息后的文字">
</stl:value>
# 说明
通过 stl:value 标签在模板中获取值
type 属性可以是指定的字符串,代表"自定义模板语言"中定义的标签名称,系统将解析对应的自定义模板标签。
<stl:value> 标签对应的实体为{stl:value}。
# 属性
属性 | 说明 |
---|---|
type | 类型 |
format | 显示的格式 |
wordNum | 显示字符的数目 |
startIndex | 字符开始位置 |
length | 指定字符长度 |
ellipsis | 文字超出部分显示的文字 |
replace | 需要被替换的文字 |
to | 替换文字 |
isClearTags | 清除标签 |
isReturnToBr | 回车改为换行 |
isLower | 转换为小写 |
isUpper | 转换为大写 |
leftText | 显示在信息前的文字 |
rightText | 显示在信息后的文字 |
# type - 类型
需要获取值的类型。此属性只可属于以下可能的取值的一种。
"siteName"
站点名称"siteUrl"
站点的域名地址"date"
当前日期(不支持 isDynamic 属性)"dateOfTraditional"
带农历的当前日期(不支持 isDynamic 属性)"currentUrl"
当前页面地址
# format - 显示的格式
当需要显示日期型的字段值时,可以通过 format 属性来设置日期格式。
# wordNum - 显示字符的数目
设置显示文字的字数,超出部分将用 ellipsis 属性设置的值替代。
TIP
wordNum 区分中英文,中文汉字算作一个字符,两个英文字母才算作一个字符。由于在 Web 页面中,两个英文字母的宽度等于一个汉字,所以我们通常使用 wordNum 属性来设置文本的显示数量。
<stl:value wordNum="50"></stl:value>
# startIndex - 字符开始位置
设置文字开始显示的位置,默认值为 0,代表从头显示。
TIP
startIndex 不区分中英文,汉字、英文字母、空格及符号均认为是一个字符。
<stl:value startIndex="10"></stl:value>
# length - 指定字符长度
设置显示文字的字数,超出部分将用 ellipsis 属性设置的值替代。
TIP
length 不区分中英文,汉字、英文字母、空格及符号均认为是一个字符。
<stl:value length="100"></stl:value>
# ellipsis - 文字超出部分显示的文字
设置了 wordNum 属性或者 length 属性时,当文字超出了指定的字数后,超出部分将用 ellipsis 属性设置的值来替代。
ellipsis 的默认值为 ...
,你也可以设置空值(ellipsis="")来让超出部分不使用符号替换。
<stl:value wordNum="100" ellipsis=" -- end --"></stl:value>
# replace - 需要被替换的文字
如果需要将文字中的一部分替换为另一部分,可以使用 replace 属性和 to 属性。
replace 代表需要替换的文字,支持纯文本、列表和正则表达式三种写法。
# 使用纯文本替换
纯文本替换直接输入替换前文字和替换后文字即可:
<stl:value replace="他" to="她"></stl:value>
# 使用列表替换
列表替换适合多个文本替换的情况,将需要替换的文字用英文逗号(,)隔开:
<stl:value replace="他,她" to="he,she"></stl:value>
如果多个文本都替换为一个文本,to 属性可以不使用逗号隔开:
<stl:value replace="他,她" to="who"></stl:value>
# 使用正则表达式替换
正则表达式替换需要将 replace 前后添加“/”符号,“/”符号之间的文字为替换需要使用的正则表达式:
<stl:value replace="/(Mr\\.? |Mrs\\.? |Miss |Ms\\.? )/" to=""></stl:value>
# to - 替换文字
to 代表替换后的文字。
# isClearTags - 清除标签
设置是否清除 HTML 标签,仅显示纯文本。
在后台内容编辑器中录入的数据通常会带有大量的 HTML 标签,如果我们只希望显示文字本身,需要使用 isClearTags 属性。
"true"
清除 HTML 标签。"false"
不清除 HTML 标签。此值是默认的,如果没有指定属性的话。
<stl:value type="siteName" isClearTags="true"></stl:value>
# isReturnToBr - 回车改为换行
设置是否将回车换行符号替换为 HTML <br>换行标签。
由于 HTML 中的换行在页面中显示为空格,所以如果需要显示后台 TextArea 文本框录入的换行时,需要使用 isReturnToBr 属性。
"true"
替换回车符。"false"
不替换回车符。此值是默认的,如果没有指定属性的话。
<stl:value type="siteName" isReturnToBr="true"></stl:value>
# isLower - 转换为小写
设置是否将文本中的所有英文字母转换为小写字母。
"true"
转换为小写。"false"
不转换为小写。此值是默认的,如果没有指定属性的话。
<stl:value type="siteName" isLower="true"></stl:value>
# isUpper - 转换为大写
设置是否将文本中的所有英文字母转换为大写字母。
"true"
转换为大写。"false"
不转换为大写。此值是默认的,如果没有指定属性的话。
<stl:value type="siteName" isUpper="true"></stl:value>
# leftText - 显示在信息前的文字
显示在文字之前的文字,系统会判断文字是否为空,如果文字为空,文字前缀也将不显示。
<stl:value leftText="标题:" type="siteName"></stl:value>
# rightText - 显示在信息后的文字
显示在文字之后的文字,系统会判断文字是否为空,如果文字为空,文字后缀也将不显示。
<stl:value leftText="【" rightText="】" type="siteName"></stl:value>
# 示例
# 显示站点名称
下面的例子显示站点名称。
<stl:value type="SiteName"></stl:value>