stl:tags 标签用法

标签

<stl:tags
    context="所处上下文"
    isDynamic="是否动态显示"
    isOrderByCount="是否按引用次数排序"
    tagLevel="标签级别"
    theme="主题样式"
    totalNum="显示标签数目"
></stl:tags>

标签(Tag)是一种互联网内容组织方式，是相关性很强的关键字，它帮助人们轻松的描述和分类内容，以便于检索和分享，Tag是web 2.0的重要标签。

stl:tags 标签用于在页面中显示标签云（Tag Cloud），标签云中标签的排列顺序依照字典排序，按照热门程度确定字体的大小和颜色。最终使得依照字典或者热门程度来寻找信息便成为可能。

标签有三个重要属性：标签名、标签使用次数、标签级别（热门程度）。通常标签显示的字体大小和颜色由标签级别决定，标签级别由系统通过标签的使用次数计算而来。

属性列表

下表显示所有属于此标签的属性列表。

属性	可能的取值	默认值	简介
tagLevel		1	标签的级别，页面将显示等于或大于此级别的标签。
totalNum			显示标签数目
context			所处上下文
	Content		仅显示当前内容包含的标签
	Channel		显示站点内所有标签
theme			显示的主题样式
	Default		默认样式
	Style1		样式一
	Style2		样式二
isorderbycount			是否按引用次数排序
	true		是
	否		静态显示
isDynamic			是否动态显示
	true		动态显示
	false		静态显示

注意

<stl:tags> 标签能够包含代码，用于控制每一条标签的显示样式。在<stl:tags>内部可以嵌入任何HTML代码和STL代码，除此以外还能够嵌入以下三种实体：标签名、标签使用次数、标签级别（热门程度）。其中标签名使用{Tag.Name}表示，标签使用次数使用{Tag.Count}表示，标签级别使用{Tag.Level}表示。

如果<stl:tags> 标签内部不包含代码，系统将采用默认的显示样式显示标签云。

如果 <stl:tags> 标签置于内容模板中，系统将仅显示当前内容包含的标签，如果希望在内容模板中显示站点内的所有标签，需要设置 context （上下文）属性为 "Channel"。

属性 tagLevel 用于控制显示标签的级别，默认显示所有级别的标签。标签分为四个级别，代表有百分之多少的内容引用了此标签：

• 级别一的标签引用百分比为0%—20%
• 级别二的标签引用百分比为20%—50%
• 级别三的标签引用百分比为50%—70%
• 级别四的标签引用百分比为70%—100%

属性 totalNum 控制显示标签数量。

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