# <stl:site> 获取站点值

<stl:site
    siteName="站点名称"
    siteDir="站点文件夹"
    type="类型"
    formatString="显示的格式"
    separator="显示多项时的分割字符串"
    wordNum="显示字符的数目"
    startIndex="字符开始位置"
    length="指定字符长度"
    ellipsis="文字超出部分显示的文字"
    replace="需要被替换的文字"
    to="替换文字"
    isClearTags="清除标签"
    isReturnToBr="回车改为换行"
    isLower="转换为小写"
    isUpper="转换为大写"
    leftText="显示在信息前的文字"
    rightText="显示在信息后的文字">
</stl:site>

# 说明

通过 stl:site 标签在模板中显示站点值

<stl:site> 必须包含 siteName 或 siteDir 属性，用于指定站点并显示内容。

<stl:site> 必须包含子标签，否则将不起作用，系统将找到对应的站点并在对应站点下解析子标签。子标签可以是任意STL标签或HTML标签。

<stl:site> 标签对应的实体为{stl:site}。

# 属性

属性	说明
siteName	站点名称
siteDir	站点文件夹
type	类型
formatString	显示的格式
separator	显示多项时的分割字符串
wordNum	显示字符的数目
startIndex	字符开始位置
length	指定字符长度
ellipsis	文字超出部分显示的文字
replace	需要被替换的文字
to	替换文字
isClearTags	清除标签
isReturnToBr	回车改为换行
isLower	转换为小写
isUpper	转换为大写
leftText	显示在信息前的文字
rightText	显示在信息后的文字

# siteName - 站点名称

站点名称，当设置 siteName 属性后，系统将定位到指定的站点，同时 <stl:site> 内嵌套的所有标签将从此站点获取数据进行解析。

# siteDir - 站点文件夹

站点文件夹，当设置 siteDir 属性后，系统将定位到指定的站点，同时 <stl:site> 内嵌套的所有标签将从此站点获取数据进行解析。

# type - 类型

显示站点属性的类型。根据后台站点字段的不同 type 属性可以有不同的取值。详细字段请参考：站点表结构。

"id" 站点 Id
"siteName" 站点名称
"siteDir" 站点文件夹
"tableName" 站点内容表
"isRoot" 是否主站
"parentId" 上级站点 Id
"taxis" 排序
"自定义字段" 在后台站点字段管理中自定义的字段名称。

# formatString - 显示的格式

当需要显示日期型的字段值时，可以通过 formatString 属性来设置日期格式。

# wordNum - 显示字符的数目

设置显示文字的字数，超出部分将用 ellipsis 属性设置的值替代。

TIP

wordNum 区分中英文，中文汉字算作一个字符，两个英文字母才算作一个字符。由于在 Web 页面中，两个英文字母的宽度等于一个汉字，所以我们通常使用 wordNum 属性来设置文本的显示数量。

<stl:site wordNum="50"></stl:site>

# startIndex - 字符开始位置

设置文字开始显示的位置，默认值为 0，代表从头显示。

TIP

startIndex 不区分中英文，汉字、英文字母、空格及符号均认为是一个字符。

<stl:site startIndex="10"></stl:site>

# length - 指定字符长度

设置显示文字的字数，超出部分将用 ellipsis 属性设置的值替代。

TIP

length 不区分中英文，汉字、英文字母、空格及符号均认为是一个字符。

<stl:site length="100"></stl:site>

# ellipsis

设置了 wordNum 属性或者 length 属性时，当文字超出了指定的字数后，超出部分将用 ellipsis 属性设置的值来替代。

ellipsis 的默认值为 ...，你也可以设置空值（ellipsis=""）来让超出部分不使用符号替换。

<stl:site wordNum="100" ellipsis=" -- end --"></stl:site>

# replace - 需要被替换的文字

如果需要将文字中的一部分替换为另一部分，可以使用 replace 属性和 to 属性。

replace 代表需要替换的文字，支持纯文本、列表和正则表达式三种写法。

# 使用纯文本替换

纯文本替换直接输入替换前文字和替换后文字即可：

<stl:site replace="他" to="她"></stl:site>

# 使用列表替换

列表替换适合多个文本替换的情况，将需要替换的文字用英文逗号（,）隔开：

<stl:site replace="他,她" to="he,she"></stl:site>

如果多个文本都替换为一个文本，to 属性可以不使用逗号隔开：

<stl:site replace="他,她" to="who"></stl:site>

# 使用正则表达式替换

正则表达式替换需要将 replace 前后添加“/”符号，“/”符号之间的文字为替换需要使用的正则表达式：

<stl:site replace="/(Mr\\.? |Mrs\\.? |Miss |Ms\\.? )/" to=""></stl:site>

# to - 替换文字

to 代表替换后的文字。

# isClearTags - 清除标签

设置是否清除 HTML 标签，仅显示纯文本。

在后台内容编辑器中录入的数据通常会带有大量的 HTML 标签，如果我们只希望显示文字本身，需要使用 isClearTags 属性。

"true" 清除 HTML 标签。
"false" 不清除 HTML 标签。此值是默认的，如果没有指定属性的话。

<stl:site type="siteName" isClearTags="true"></stl:site>

# isReturnToBr - 回车改为换行

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

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

"true" 替换回车符。
"false" 不替换回车符。此值是默认的，如果没有指定属性的话。

<stl:site type="siteName" isReturnToBr="true"></stl:site>

# isLower - 转换为小写

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

"true" 转换为小写。
"false" 不转换为小写。此值是默认的，如果没有指定属性的话。

<stl:site type="siteName" isLower="true"></stl:site>

# isUpper - 转换为大写

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

"true" 转换为大写。
"false" 不转换为大写。此值是默认的，如果没有指定属性的话。

<stl:site type="siteName" isUpper="true"></stl:site>

# leftText - 显示在信息前的文字

显示在文字之前的文字，系统会判断文字是否为空，如果文字为空，文字前缀也将不显示。

<stl:site leftText="标题：" type="siteName"></stl:site>

# rightText - 显示在信息后的文字

显示在文字之后的文字，系统会判断文字是否为空，如果文字为空，文字后缀也将不显示。

<stl:site leftText="【" rightText="】" type="siteName"></stl:site>

# 示例

# 显示指定站点的内容

下面的例子显示站点 "SiteServer STL" 下新闻栏目的内容列表。

<stl:site siteName="站点">
  <ul>
      <stl:contents channelIndex="新闻" layout="None">
          <li><stl:a target="_blank"></stl:a></li>
      </stl:contents>
  </ul>
</stl:site>