Siteserver-stl:contentsItem内容列表项
来自站长百科
导航: 上一页
stl:contentsItem 内容列表项
- 控制内容列表中每一项的显示内容及样式 ,请参考 列表元素及列表项
属性列表
下表显示所有属于此元素的属性列表。
属性 | 可能的取值 | 默认值 | 简介 |
---|---|---|---|
type | 列表项的类型 | ||
Header | 为列表提供头部内容。 | ||
Footer | 为列表提供底部内容。 | ||
Item | √ | 为内容列表中的项提供内容和布局所要求的模板。 | |
AlternatingItem | 如果已定义,则为内容列表中的交替项提供内容和布局。如果未定义,则使用 Item。 | ||
SelectedItem | 如果已定义,则为内容列表中选定项提供内容和布局。如果未定义,则使用Item。 | ||
Separator | 如果已定义,则为内容列表中各项之间的分隔符提供内容和布局。如果未定义,将不显示分隔符。 | ||
selected | 决定SelectedItem的选定内容项类型 | ||
Current | √ | 使用当前内容为选定的内容 | |
Image | 使用拥有图片的内容为选定的内容 | ||
File | 使用拥有附件的内容为选定的内容 | ||
IsTop | 使用设为置顶的内容为选定的内容 | ||
IsRecommend | 使用设为推荐的内容为选定内容 | ||
IsHot | 使用设为热点的内容为选定内容 | ||
IsColor | 使用设为醒目的内容为选定内容 | ||
n | n为数字,代表列表的第n项为显示选择项,如:1 | ||
n,m,p... | 字母为数字,代表列表的第n,m,p等项为选择项,如:2,4,6 | ||
n-m | n及m为数字,代表列表的第n项到第m项为选择项,如:2-8 | ||
ChannelName | 选择指定栏目名称的内容项 | ||
selectedValue | 如果selected为ChannelName,selectedValue应该为栏目名称 |
注意
- <stl:contentsItem> 元素必须包含在元素 <stl:contents> 或 <stl:pageContents> 内使用。
- Item 类型的栏目列表项可以为空,系统将使用列表元素中除列表项以外的其他内容作为 Item 类型列表项的值。
- Item、AlternatingItem、Separator三种类型的栏目列表项在内容列表中最多只能有一个,SelectedItem类型的内容列表项可以有零个或多个。
- SelectedItem 类型的内容列表项所显示的内容由 selected 属性控制,默认当前内容为选中项。
stl:contentsItem 示例
- 示例一:显示指定的内容列表
下面的例子显示栏目"新闻"下的内容列表,对设置为醒目的内容采用红色显示。
<stl:contents channelName="新闻"> <stl:contentsItem type="Item"> <stl:a target="_blank"></stl:a> </stl:contentsItem> <stl:contentsItem type="SelectedItem" selected="IsColor"> <stl:a style="color:red" target="_blank"></stl:a> </stl:contentsItem> </stl:contents> <stl:contents channelName="新闻"> <stl:contentsItem type="Item"> <stl:a target="_blank"></stl:a> </stl:contentsItem> <stl:contentsItem type="SelectedItem" selected="IsColor"> <stl:a style="color:red" target="_blank"></stl:a> </stl:contentsItem> </stl:contents>
- 示例二:定制列表中交替项的显示内容
下面的例子显示栏目名称为"新闻"的所有内容的列表,列表的交替项与列表项的显示颜色有所不同。
<stl:contents channelName="新闻"> <stl:contentsItem type="Item"> <stl:a><stl:content type="Title"></stl:content></stl:a> </stl:contentsItem> <stl:contentsItem type="AlternatingItem"> <stl:a style="color:red"><stl:content type="Title"></stl:content></stl:a> </stl:contentsItem> </stl:contents> <stl:contents channelName="新闻"> <stl:contentsItem type="Item"> <stl:a><stl:content type="Title"></stl:content></stl:a> </stl:contentsItem> <stl:contentsItem type="AlternatingItem"> <stl:a style="color:red"><stl:content type="Title"></stl:content></stl:a> </stl:contentsItem> </stl:contents>