编辑“Siteserver-stl:a获取链接”

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

'''stl:a 获取链接'''

获取栏目页或内容页的[[链接]]。

*如果此标签在栏目模版中默认代表此栏目页的链接，如果此标签在内容模版中，默认代表此内容页的链接。
*如果此标签嵌入在列表标签内，则代表当前列表项的链接。 

'''属性列表'''

下表显示所有属于此元素的属性列表。所有属于[[HTML]] 元素<a>的成员均适用于<stl:a>元素。 属于HTML 元素<a>的成员未在下表列出。

{| cellSpacing=0 cellPadding=0 border=1<TBODY>
|-
! 属性
! width="18%" | 可能的取值
! width="18%" | 默认值
! 简介
|-
| ID
| &nbsp;
| &nbsp;
| 此对象的唯一标识符
|-
|channelIndex
| &nbsp;
| &nbsp;
| 栏目索引
|-
| channelName
| &nbsp;
| &nbsp;
| 栏目名称
|-
| parent
| &nbsp;
| &nbsp;
| 是否显示父栏目的链接。此属性只可属于以下可能的取值的一种。
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | true
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 显示父栏目的链接，等价于upLevel="1"
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | false
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 不显示父栏目的链接
|-
| upLevel
| &nbsp;
| &nbsp;
| 显示上几级栏目的链接，0为本级，1为父栏目，以此类推。
|-
| topLevel
| &nbsp;
| &nbsp;
| 显示从首页向下某个级别栏目的链接，0代表[[网站]]首页，1代表一级栏目，以此类推。
|-
| 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 | 链接将解析为栏目链接
|-
| href
| &nbsp;
| &nbsp;
| 链接地址，可以用“@”开头表示当前网站根目录，用“~”开头表示系统根目录。
|-
| queryString
| &nbsp;
| &nbsp;
| 链接地址后的参数
|-
| action
| &nbsp;
| &nbsp;
| 点击链接的动作
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | AddFavorite
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 将页面添加至收藏夹
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | SetHomePage
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 将页面设置为首页
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Close
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 关闭页面
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | AddContent
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 添加内容，可作为投稿功能使用
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | SendMail
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 发送此页到邮箱
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Comments
| 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" | &nbsp;
| bgColor=#ffffcc | 静态显示

|}


'''注意'''

元素<stl:a>在栏目模版中默认显示此栏目的链接，在内容[[模版]]中默认显示此内容的链接，如果指定所处上下文context，元素将按照上下文解析。

* stl:a 元素能够作为<stl:channels>等元素的子元素，当作为<stl:channels>的子元素使用时将显示栏目链接。
* stl:a 元素能够作为<stl:contents>等元素的子元素，当作为<stl:contents>的子元素使用时将显示内容链接。
* 可以把任何STL 元素作为stl:a 元素的子元素。

如果没有指定链接的文字信息，链接显示的文字将为栏目/内容的名称。

* 如果设置了 channelIndex 属性，系统将寻找对应此栏目索引的栏目并显示此栏目的链接。 
* 如果设置了 channelName 属性，系统将寻找对应此栏目名称的栏目并显示此栏目的链接。 
* 如果设置了parent、upLevel或topLevel属性，系统将寻找上级或上几级的栏目并显示此栏目的链接。
* 如果设置了action属性，点击链接后将发生对应事件。

'''stl:a 示例'''

'''示例一：显示指定的栏目链接'''

下面的例子显示栏目名称为"站点地图"的栏目链接，点击链接后在新窗口打开。
 <pre>    
<stl:a channelName="站点地图" target="_blank">    
</stl:a>   
 
<stl:a channelName="站点地图" target="_blank"> 
</stl:a> 
</pre>

'''示例二：在内容列表中显示内容链接'''

下面的例子显示栏目索引为"新闻"的栏目的内容列表，内容链接的提示为内容标题。 
<pre>
    
<stl:contents index="新闻" width="80%" border="0">    
    <stl:a title="stl:a 示例" target="_blank"></stl:a>    
</stl:contents>   
 
<stl:contents index="新闻" width="80%" border="0"> 
    <stl:a title="stl:a 示例" target="_blank"></stl:a> 
</stl:contents> 
 </pre>

'''示例三：在栏目链接中显示指定的文字'''

下面的例子显示栏目名称为"站点地图"的栏目链接，链接文字为"转到站点地图"。 
<pre>
    
<stl:a channelName="站点地图" target="_blank">    
转到站点地图    
</stl:a>   
</pre>

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

[[category:SiteServer|S]]