编辑“Siteserver-stl:tags标签”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Siteserver二次开发指南|上一页]]</span>
<div style="clear:both;"></div>

'''stl:tags 标签'''

*标签(Tag)是一种互联网内容组织方式，是相关性很强的关键字，它帮助人们轻松的描述和分类内容，以便于检索和分享，Tag是[[web]] 2.0的重要元素。
*stl:tags 元素用于在页面中显示标签云（Tag Cloud），标签云中标签的排列顺序依照字典排序，按照热门程度确定字体的大小和颜色。最终使得依照字典或者热门程度来寻找信息便成为可能。
*标签有三个重要属性：标签名、标签使用次数、标签级别（热门程度）。通常标签显示的字体大小和颜色由标签级别决定，标签级别由系统通过标签的使用次数计算而来。

'''属性列表'''

*下表显示所有属于此元素的属性列表。

{| border="1" cellpadding="0" cellspacing="0"
|-
! 属性
! width="18%" | 可能的取值
! width="18%" | 默认值
! 简介
|-
| tagLevel
| &nbsp;
| 1
| 标签的级别，页面将显示等于或大于此级别的标签。
|-
| totalNum
| &nbsp;
| &nbsp;
| 显示标签数目
|-
| context
| &nbsp;
| &nbsp;
| 所处上下文
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Content
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 仅显示当前内容包含的标签
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Channel
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 显示站点内所有标签
|-
| theme
| &nbsp;
| &nbsp;
| 显示的主题样式
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Default
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 默认样式
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Style1
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 样式一
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Style2
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 样式二
|-
| isDynamic
| &nbsp;
| &nbsp;
| 是否动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | true
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | false
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 静态显示
|}

'''注意:'''
*<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 示例'''

*示例一：默认方式显示标签云.下面的例子显示站点内的所有标签，显示数量为30。

<pre>
<stl:tags totalNum="30"></stl:tags>  
<stl:tags totalNum="30"></stl:tags>
</pre>

*示例二：自定义标签显示样式.下面的例子采用自定义的方式显示标签。
<pre>
<div class="mod">  
<div class="mBody">  
<div class="tagHead">标签列表</div>  
<ul class="tagCloud">  
    <stl:tags>  
    <li class="tag_popularity_{Tag.Level}">  
        <stl:a target="_blank" href="/utils/tags.html?tagName={Tag.Name}">{Tag.Name}</stl:a>  
    </li>  
    </stl:tags>  
</ul>  
</div>  
</div>  
<div class="mod">
<div class="mBody">
<div class="tagHead">标签列表</div>
<ul class="tagCloud">
	<stl:tags>
    <li class="tag_popularity_{Tag.Level}">
        <stl:a target="_blank" href="/utils/tags.html?tagName={Tag.Name}">{Tag.Name}</stl:a>
    </li>
    </stl:tags>
</ul>
</div>
</div>
</pre>

==参考资料==
*[http://help.siteserver.cn SiteServer官方]

[[category:SiteServer|S]]