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>  
 

参考资料

• SiteServer官方