Siteserver-stl:contents内容列表

导航: 上一页

stl:contents 内容列表

在模板中插入内容的列表

属性列表

下表显示所有属于此元素的属性列表。所有属于ASP.NET元素 <asp:DataList> 或HTML元素

的成员均适用于 <stl:contents> 元素。

属性	可能的取值	默认值	简介
channelIndex			栏目索引
channelName			栏目名称
upLevel			显示上几级栏目的内容列表，0为本级，1为父栏目，以此类推。
topLevel			显示从首页向下某个级别栏目的内容列表，0代表网站首页，1代表一级栏目，以此类推。
scope			内容范围。此属性只可属于以下可能的取值的一种。
	Self	√	只显示本栏目下的所有内容
	Children		只显示下一极子栏目下的所有内容
	SelfAndChildren		显示本级栏目及下一极子栏目下的所有内容
	Descendant		显示所有级别的子栏目下的所有内容
	All		显示全部内容
isImage			是否只显示带有图片（不带图片）的内容。
	true		仅显示带有图片的内容
	false		仅显示不带图片的内容
isFile			是否只显示带有附件（不带附件）的内容。
	true		仅显示带有附件的内容
	false		仅显示不带附件的内容
isDisplayIfEmpty			当内容列表项不存在时是否仍然显示
	true		内容列表项不存在时仍然显示
	false	√	内容列表项不存在时不显示
isTop			是否只显示置顶（非置顶）内容。
	true		仅显示置顶的内容
	false		仅显示非置顶的内容
isRecommend			是否只显示推荐（非推荐）内容。
	true		仅显示推荐的内容
	false		仅显示非推荐的内容
isHot			是否只显示热点（非热点）内容。
	true		仅显示热点的内容
	false		仅显示非热点的内容
isColor			是否只显示醒目（非醒目）内容。
	true		仅显示醒目的内容
	false		仅显示非醒目的内容
isRelatedContents			是否显示相关内容列表
	true		显示相关内容列表
	false	√	不显示相关内容列表
groupChannel			栏目组别，如设置此属性，则只显示指定栏目组别的内容列表。
groupChannelNot			非栏目组别，如设置此属性，则只显示不等于指定栏目组别的内容列表。
groupContent			内容组别，如设置此属性，则只显示指定内容组别的内容列表。
groupContentNot			非内容组别，如设置此属性，则只显示不等于内容组别的内容列表。
order			内容列表排序方式。此属性只可属于以下可能的取值的一种。
	Default	√	默认排序，即内容管理界面中的排序
	Back		默认排序的相反方向
	AddDate		按添加时间排序
	AddDateBack		按添加时间的相反方向排序
	LastEditDate		按最后更改时间排序
	LastEditDateBack		按最后更改时间的相反方向排序
	Hits		按点击量排序
	Stars		按评分数排序
	Digg		按点评数排序
totalNum			设置列表一共显示多少条信息，0代表显示所有信息。
startNum		1	从第几条信息开始显示，默认从第一条信息开始显示。
titleWordNum			设置内容标题显示的字数，0代表不限制字数。
tags			仅显示指定标签的内容列表，多个标签用“,”分隔。
where			获取内容列表的条件判断
columns		1	列数，默认显示一列
direction			方向
	Vertical	√	垂直
	Horizontal		水平
layout			重复布局
	Table		表格布局
	Flow		SPAN标签布局
	None	√	无，常用于Div+Css形式页面
itemHeight			列表中每一项的高度
itemWidth			列表中每一项的宽度
itemAlign			列表中每一项的水平对齐方式
	Center		居中对齐
	Left	√	居左对齐
	Right		居右对齐
	Justify		向页面的左右边缘对齐
	NotSet		不设置
itemVerticalAlign			列表中每一项的垂直对齐方式
	Top	√	顶端对齐
	Middle		居中对齐
	Bottom		底端对齐
	NotSet		不设置
itemClass			项CSS类
class			整体CSS类
target			控制链接打开窗口的目标
height			列表的整体高度
width			列表的整体宽度
align			列表的整体对齐方式
	Center		居中对齐
	Left		居左对齐
	Right		居右对齐
	Justify		向页面的左右边缘对齐
	NotSet		不设置
cellpadding			填充像素值
cellspacing			间距像素值
isDynamic			是否动态显示
	true		动态显示
	false	√	静态显示

注意:

• 如果设置了 channelIndex 属性，系统将寻找对应此栏目索引的栏目并显示此栏目的内容列表。
• 如果设置了 channelName 属性，系统将寻找对应此栏目名称的栏目并显示此栏目的内容列表。

columns、direction和layout三个属性控制生成列表的HTML标签。

• columns控制生成列表的列数，direction控制生成列表的方向，layout控制生成列表的HTML元素。
• layout为Table时系统使用<table>标签生成列表，layout为Flow时系统使用标签生成列表，默认为None，即仅循环列表项。
• titleWordNum属性控制生成列表中标题的显示字数，作用于<stl:content type="title">。

如果需要在内容页中显示与当前内容相关的内容列表，使用isRelatedContents="true"属性，系统将根据标签判断是否相关内容。

stl:contents示例

• 示例一：显示指定的栏目的内容列表

下面的例子显示栏目名称为"新闻"的栏目下的所有被设置为推荐内容的列表。

    
<stl:contents channelName="新闻" isRecommend="true" scope="Self">    
</stl:contents>   
 <stl:contents channelName="新闻" isRecommend="true" scope="Self"> 
</stl:contents> 

• 示例二：定制列表中每一项的显示内容

下面的例子显示栏目名称为"新闻"的栏目下的所有内容的列表。

    <stl:contents channelName="新闻">    
    <img src="nav.gif" />    
    <stl:a><stl:content type="Title"></stl:content></stl:a>    
</stl:contents>   
 
<stl:contents channelName="新闻"> 
    <img src="nav.gif" /> 
    <stl:a><stl:content type="Title"></stl:content></stl:a> 
</stl:contents> 

• 示例三：列表显示两列

下面的例子显示的列表列数为两列，并设置生成的表格的样式。

 <stl:contents channelName="新闻" columns="2" width="90%" border="0" cellpadding="2">    
<stl:image border="0"></stl:image>    
<stl:a><stl:content type="Title"></stl:content></stl:a>    
</stl:contents>   

参考资料

• SiteServer官方