显示在信息前的文字
显示在信息后的文字
显示的格式
显示多项时的分割字符串
显示字符的数量
字符开始位置
指定字符宽度
文字超出部份显示的文字
需要被替换的文字
替换文字
清除标签
回车改为换行
转换为大写
转换为小写
type - 显示的类型
显示栏目属性的类型。根据后台栏目数组的不同 type 属性可以有不同的取值。详细数组请参考:。
channelIndex - 栏目索引
栏目索引是一个站点中栏目的标示,具有唯一性。
如果设置了 channelIndex 属性,系统将找寻对应索引的栏目并将上下文切换到此栏目。
<stl:channel channelIndex="首页" type="content">stl:channel>
channelName - 栏目名称
栏目名称可以重复,所以应当尽量避开使用栏目名称来切换上下文,但是假如 channelName 与 channelIndex 属性配合使用,系统将首先定位到 channelIndex 索引所在的栏目,之后再找寻此栏目下栏目名称为 channelName 的栏目。
<stl:channel channelName="栏目名称" type="content">stl:channel>
<stl:channel channelIndex="栏目索引" channelName="栏目名称" type="content">stl:channel>
parent - 显示父栏目属性
将上下文切换到当前栏目的上一级栏目。
如果同时设置了 parent 以及 channelIndex 属性,系统将首先定位到 channelIndex 栏目索引所在的栏目,之后再切换到对应栏目的上级栏目。
<stl:channel parent="true" type="content">stl:channel>
upLevel - 上级栏目的级别
切换到上级栏目,1 为上一级栏目,2 为上两级栏目,以此类推。
如果同时设置了 upLevel 以及 channelIndex 属性,系统将首先定位到 channelIndex 栏目索引所在的栏目,之后再切换到对应栏目的上 N 级栏目。
<stl:channel upLevel="2" type="content">stl:channel>
topLevel - 从首页向上的栏目级别
切换到从首页向上第 N 个级别的栏目,0 代表切换到首页,1 代表一级栏目,2 代表二级栏目,以此类推。
<stl:channel topLevel="1" type="content">stl:channel>
leftText - 显示在信息前的文字
显示在文字之前的文字,系统会判定文字是否为空,如果文字为空,文字前缀也将不显示。
<stl:channel leftText="标题:" type="title">stl:channel>
rightText - 显示在信息后的文字
显示在文字以后的文字,系统会判定文字是否为空,如果文字为空,文字后缀也将不显示。
<stl:channel leftText="【" rightText="】" type="title">stl:channel>
format - 显示的格式
当须要显示日期型的数组值时,可以通过 format 属性来设置日期格式。
<stl:channel type="AddDate" format="yyyy-MM-dd">stl:channel>
separator - 显示多项时的分割字符串
显示多项时的分割字符串。
wordNum - 显示字符的数量
设置显示文字的字数,超出部份将用 ellipsis 属性设置的值取代。
TIP
wordNum 区分中英文,中文汉字算作一个字符,两个英语字母才算作一个字符。由于在 Web 页面中,两个英语字母的长度等于一个汉字,所以我们一般使用 wordNum 属性来设置文本的显示数目。
<stl:channel wordNum="50">stl:channel>
startIndex - 字符开始位置
设置文字开始显示的位置,默认值为 0,代表从头显示。
TIP
startIndex 不分辨中英文,汉字、英文字母、空格及符号均觉得是一个字符。
<stl:channel startIndex="10">stl:channel>
length - 指定字符宽度
设置显示文字的字数,超出部份将用 ellipsis 属性设置的值取代。
TIP
length 不分辨中英文,汉字、英文字母、空格及符号均觉得是一个字符。
<stl:channel length="100">stl:channel>
ellipsis - 文字超出部份显示的文字
设置了 wordNum 属性或则 length 属性时,当文字超出了指定的字数后,超出部份将用 ellipsis 属性设置的值来取代。
ellipsis 的默认值为 ...,你也可以设置空值(ellipsis="")来让超出部份不使用符号替换。
<stl:channel wordNum="100" ellipsis=" -- end --">stl:channel>
replace - 需要被替换的文字
如果须要将文字中的一部分替换为另一部分,可以使用 replace 属性和 to 属性。
replace 代表须要替换的文字,支持纯文本、列表和正则表达式三种写法。
使用纯文本替换
纯文本替换直接输入替换前文字和替换后文字即可:
<stl:channel replace="他" to="她">stl:channel>
使用列表替换
列表替换适宜多个文本替换的情况,将须要替换的文字用英语冒号(,)隔开:
<stl:channel replace="他,她" to="he,she">stl:channel>
如果多个文本都替换为一个文本,to 属性可以不使用冒号隔开:
<stl:channel replace="他,她" to="who">stl:channel>
使用正则表达式替换
正则表达式替换须要将 replace 前后添加“/”符号,“/”符号之间的文字为替换须要使用的正则表达式:
<stl:channel replace="/(Mr\\.? |Mrs\\.? |Miss |Ms\\.? )/" to="">stl:channel>
to 替换文字
to 代表替换后的文字。
isClearTags - 清除标签
设置是否去除 HTML 标签,仅显示纯文本。
在后台内容编辑器中录入的数据一般会带有大量的 HTML 标签,如果我们只希望显示文字本身,需要使用 isClearTags 属性。
<stl:channel type="content" isClearTags="true">stl:channel>
isReturnToBr - 回车改为换行
设置是否将回车换行符号替换为 HTML
换行标签。
由于 HTML 中的换行在页面中显示为空格,所以假如须要显示后台 TextArea 文本框录入的换行时,需要使用 isReturnToBr 属性。
<stl:channel type="description" isReturnToBr="true">stl:channel>
isLower - 转换为大写
设置是否将文本中的所有英语字母转换为大写字母。
<stl:channel type="title" isLower="true">stl:channel>
isUpper - 转换为小写
设置是否将文本中的所有英语字母转换为大写字母。
<stl:channel type="title" isUpper="true">stl:channel>
示例 指定栏目的子栏目名称列表
下面的事例显示栏目“首页”的所有子栏目名称。
<stl:channels channelIndex="首页">
<stl:channel type="Title">stl:channel><br>
stl:channels>
解析后的 HTML 代码:
新闻<br>
人才招聘<br>
互动交流<br>
信息公开<br>
在栏目列表中显示栏目名称以及内容数
下面的事例显示上级栏目的所有子栏目名称列表,并在名称后显示对应的内容数。
<stl:channels upLevel="1">
<stl:channel type="Title">stl:channel>(<stl:channel type="CountOfContents">stl:channel>)<br>
stl:channels>
解析后的 HTML 代码:
stl:channels 栏目列表(3)<br>
stl:channel 获取栏目值(3)<br>
显示当前栏目的名称
下面的事例显示当前栏目的栏目名称。
<stl:channel type="Title">stl:channel>
解析后的 HTML 代码:
stl:channel 获取栏目值
显示指定栏目的所有下级栏目数目
下面的事例显示栏目索引为"首页"的所有下级栏目数目。
<stl:channel channelIndex="首页" type="CountOfChannels">stl:channel>
解析后的 HTML 代码:
110
显示父栏目的栏目内容
下面的事例显示父栏目的栏目内容。
<stl:channel parent="true" type="Content">stl:channel>
解析后的 HTML 代码:
<p style="color:#333333;font-family:'helvetica neue', helvetica, arial, sans-serif;font-size:14px;line-height:20px;margin-top:0px;margin-bottom:10px;">栏目标签包含获取栏目列表以及栏目属性的相关标签p>