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>