Siteserver-stl:a获取链接

导航: 上一页

stl:a 获取链接

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

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

属性列表

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

属性	可能的取值	默认值	简介
ID			此对象的唯一标识符
channelIndex			栏目索引
channelName			栏目名称
parent			是否显示父栏目的链接。此属性只可属于以下可能的取值的一种。
	true		显示父栏目的链接，等价于upLevel="1"
	false		不显示父栏目的链接
upLevel			显示上几级栏目的链接，0为本级，1为父栏目，以此类推。
topLevel			显示从首页向下某个级别栏目的链接，0代表网站首页，1代表一级栏目，以此类推。
context			链接所处上下文
	Content		链接将解析为内容链接
	Channel		链接将解析为栏目链接
href			链接地址，可以用“@”开头表示当前网站根目录，用“~”开头表示系统根目录。
queryString			链接地址后的参数
action			点击链接的动作
	AddFavorite		将页面添加至收藏夹
	SetHomePage		将页面设置为首页
	Close		关闭页面
	AddContent		添加内容，可作为投稿功能使用
	SendMail		发送此页到邮箱
	Comments		链接到评论页面
isDynamic			是否动态显示
	true		动态显示
	false		静态显示

注意

元素<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 示例

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

下面的例子显示栏目名称为"站点地图"的栏目链接，点击链接后在新窗口打开。

    
<stl:a channelName="站点地图" target="_blank">    
</stl:a>   
 
<stl:a channelName="站点地图" target="_blank"> 
</stl:a> 

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

下面的例子显示栏目索引为"新闻"的栏目的内容列表，内容链接的提示为内容标题。

    
<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> 
 

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

下面的例子显示栏目名称为"站点地图"的栏目链接，链接文字为"转到站点地图"。

    
<stl:a channelName="站点地图" target="_blank">    
转到站点地图    
</stl:a>   

参考资料

• SiteServer官方