编辑“Siteserver-stl:contents内容列表”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Siteserver二次开发指南|上一页]]</span>
<div style="clear:both;"></div>

'''stl:contents 内容列表'''

在[[模板]]中插入内容的列表

'''属性列表'''

下表显示所有属于此元素的属性列表。所有属于[[ASP.NET]]元素 <asp:DataList> 或[[HTML]]元素 <table> 的成员均适用于 <stl:contents> 元素。

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


'''注意''':

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

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

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


'''stl:contents示例'''

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

下面的例子显示栏目名称为"新闻"的栏目下的所有被设置为推荐内容的列表。
 
<pre>    
<stl:contents channelName="新闻" isRecommend="true" scope="Self">    
</stl:contents>   
 <stl:contents channelName="新闻" isRecommend="true" scope="Self"> 
</stl:contents> 
</pre>

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

下面的例子显示栏目名称为"新闻"的栏目下的所有内容的列表。
 
<pre>
    <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> 
</pre>

*'''示例三'''：列表显示两列

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

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


==参考资料==
*[http://help.siteserver.cn SiteServer官方]

[[category:SiteServer|S]]