SSCMS 7.3 文档中心

# <stl:channel> 获取栏目值

<stl:channel
    type="显示的类型"
    channelIndex="栏目索引"
    channelName="栏目名称"
    parent="显示父栏目属性"
    upLevel="上级栏目的级别"
    topLevel="从首页向下的栏目级别"
    leftText="显示在信息前的文字"
    rightText="显示在信息后的文字"
    format="显示的格式"
    separator="显示多项时的分割字符串"
    wordNum="显示字符的数目"
    startIndex="字符开始位置"
    length="指定字符长度"
    ellipsis="文字超出部分显示的文字"
    replace="需要被替换的文字"
    to="替换文字"
    isClearTags="清除标签"
    isReturnToBr="回车改为换行"
    isLower="转换为小写"
    isUpper="转换为大写">
</stl:channel>

# 说明

通过 stl:channel 标签在模板中显示指定栏目的属性值。

<stl:channel> 标签单独使用时，系统默认将显示当前栏目的值，如果希望显示指定栏目的值，请设置 上下文切换 属性。

如果 <stl:channel> 标签嵌套在 <stl:channels>以及<stl:pageChannels> 栏目列表标签内，系统将获取栏目列表项并解析为相应的值。

type 属性用于明确需要显示栏目的具体字段，如果未设置，系统将显示栏目名称。

如果需要对返回的文字进行截字或者其他处理，请设置 解析文字 属性。

如果需要显示日期/时间类型的栏目字段，可以通过 format 属性 格式化日期。

如果希望将栏目的属性值放到 HTML 元素或者 STL 元素的属性中使用，请使用{stl:channel} 实体写法，如：<a title="{stl:channel type=title}">。

如果需要获取栏目正文并翻页显示，请设置type属性为 pageContent，同时配合 stl:pageItem 标签实现翻页效果。

# 解析

如果使用 <stl:channel> 元素，系统将根据栏目字段的类型解析为不同的值（通常为字符串，如果字段类型为图片系统将解析为<img>标签）。

如果使用 {stl:channel} 实体，系统将根据是否设置type 属性，解析为不同的结果：

  • 设置了type属性，系统将实体解析为栏目的具体字段值。
  • 未设置type属性，系统将实体解析为栏目的JSON对象。

# 属性

属性 说明
type 显示的类型
channelIndex 栏目索引
channelName 栏目名称
parent 显示父栏目属性
upLevel 上级栏目的级别
topLevel 从首页向下的栏目级别
leftText 显示在信息前的文字
rightText 显示在信息后的文字
format 显示的格式
separator 显示多项时的分割字符串
wordNum 显示字符的数目
startIndex 字符开始位置
length 指定字符长度
ellipsis 文字超出部分显示的文字
replace 需要被替换的文字
to 替换文字
isClearTags 清除标签
isReturnToBr 回车改为换行
isLower 转换为小写
isUpper 转换为大写

# type - 显示的类型

显示栏目属性的类型。根据后台栏目字段的不同 type 属性可以有不同的取值。详细字段请参考：栏目表结构 (opens new window)。

  • "title" 显示栏目的名称。此值是默认的，如果没有指定属性的话。
  • "id" 栏目 Id。
  • "channelIndex" 栏目索引。
  • "content" Content。
  • "pageContent" 能够翻页显示的栏目正文。
  • "addDate" 显示栏目添加日期。
  • "imageUrl" 显示栏目图片。
  • "itemIndex" 项次序数字。
  • "channels" 子栏目数。
  • "contents" 内容数。
  • "imageContents" 图片内容数。
  • "keywords" 关键字。
  • "description" 页面描述。
  • "自定义字段" 在后台栏目字段管理中自定义的字段名称。

# 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 - 显示父栏目属性

将上下文切换到当前栏目的上一级栏目。

  • "true" 表示切换到当前栏目的上一级栏目，等价于 upLevel="1"。
  • "false" 表示不切换到当前栏目的上一级栏目。

如果同时设置了 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 HH:mm:ss"></stl:channel>

我们也可以通过 format 属性来设置数字格式：

<stl:channel type="ItemIndex" format="D2"></stl:channel>

以上示例将用前导零填充数值，如数值为1，格式化后将显示为01。

# 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 属性。

  • "true" 清除 HTML 标签。
  • "false" 不清除 HTML 标签。此值是默认的，如果没有指定属性的话。
<stl:channel type="content" isClearTags="true"></stl:channel>

# isReturnToBr - 回车改为换行

设置是否将回车换行符号替换为 HTML <br>换行标签。

由于 HTML 中的换行在页面中显示为空格，所以如果需要显示后台 TextArea 文本框录入的换行时，需要使用 isReturnToBr 属性。

  • "true" 替换回车符。
  • "false" 不替换回车符。此值是默认的，如果没有指定属性的话。
<stl:channel type="description" isReturnToBr="true"></stl:channel>

# isLower - 转换为小写

设置是否将文本中的所有英文字母转换为小写字母。

  • "true" 转换为小写。
  • "false" 不转换为小写。此值是默认的，如果没有指定属性的话。
<stl:channel type="title" isLower="true"></stl:channel>

# isUpper - 转换为大写

设置是否将文本中的所有英文字母转换为大写字母。

  • "true" 转换为大写。
  • "false" 不转换为大写。此值是默认的，如果没有指定属性的话。
<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>
上次更新: 2023/9/7 下午4:59:53