编辑“Siteserver-stl:channels栏目列表”

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

'''stl:channels 栏目列表'''

在[[模板]]中插入栏目的列表 

'''属性列表'''

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

{| cellSpacing=0 cellPadding=0 border=1
|-
! width="17%" | 属性
! width="18%" | 可能的取值
! width="18%" | 默认值
! width="65%" | 简介
|-
| channelIndex
| &nbsp;
| &nbsp;
| 栏目索引
|-
| channelName
| &nbsp;
| &nbsp;
| 栏目名称
|-
| upLevel
| &nbsp;
| &nbsp;
| 显示上几级栏目的下级栏目列表，0为显示下级栏目列表，1为显示同级栏目列表，2为显示父栏目的同级栏目列表，以此类推。
|-
| topLevel
| &nbsp;
| &nbsp;
| 显示从首页向下某个级别栏目的下级栏目列表，0代表网站首页，1代表一级栏目，以此类推。
|-
| isTotal
| &nbsp;
| &nbsp;
| 是否从所有栏目中选择（包括首页）
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | true
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 从网站的所有栏目中选择合适的栏目进行显示
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | false
| bgColor=#ffffcc | 
| bgColor=#ffffcc | 不从所有栏目总选择
|-
| isAllChildren
| &nbsp;
| &nbsp;
| 是否显示所有级别的子栏目
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | true
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 显示所有级别的子栏目
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | false
| bgColor=#ffffcc | 
| bgColor=#ffffcc | 只显示子栏目，不包括子栏目的子栏目。
|-
| isImage
| &nbsp;
| &nbsp;
| 是否只显示带有图片的栏目。此属性只可属于以下可能的取值的一种。
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | true
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 只显示带有图片的栏目
|-
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | false
| bgColor=#ffffcc | 
| 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 | 栏目列表项不存在时不显示
|-
| groupChannel
| &nbsp;
| &nbsp;
| 栏目组别，如设置此属性，则只显示栏目组别等于group的栏目列表。
|-
| groupChannelNot
| &nbsp;
| &nbsp;
| 非栏目组别，如设置此属性，则只显示栏目组别不等于group的栏目列表。
|-
| 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 | Hits
| bgColor=#ffffcc | &nbsp;
| bgColor=#ffffcc | 按点击量排序
|-
| totalNum
| &nbsp;
| &nbsp;
| 设置列表一共显示多少条信息，0代表显示所有信息。
|-
| startNum
| &nbsp;
| 1
| 从第几条信息开始显示，默认从第一条信息开始显示。
|-
| titleWordNum
| &nbsp;
| &nbsp;
| 设置栏目标题显示的字数，0代表不限制字数
|-
| 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;
| 重复布局
|-
| 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时系统使用<table>标签生成列表，layout为Flow时系统使用<span>标签生成列表，默认为None，即仅循环列表项。

*titleWordNum属性控制生成列表中标题文字的显示字数，作用于<stl:channel type="title">。


'''stl:channels 示例'''

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

下面的例子显示栏目名称为"新闻"的栏目下的所有子栏目的列表。
<pre>
    
<stl:channels name="新闻"></stl:channels>   
 
<stl:channels name="新闻"></stl:channels> 
</pre>

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

下面的例子显示栏目名称为"新闻"的栏目下的所有子栏目的列表。 
<pre>
<stl:channels name="新闻">    
    <img src="nav.gif" />    
    <stl:a><stl:channel type="title"></stl:channel></stl:a>    
</stl:channels>   
 
<stl:channels name="新闻"> 
    <img src="nav.gif" /> 
    <stl:a><stl:channel type="title"></stl:channel></stl:a> 
</stl:channels> 
</pre>

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

下面的例子显示的列表列数为两列，并设置生成的表格的样式。 
<pre>
    
<stl:channels name="新闻" columns="2" width="90%" border="0" cellpadding="2">    
    <stl:image border="0"></stl:image>    
    <stl:a><stl:channel type="title"></stl:channel></stl:a>    
</stl:channels>   
 
<stl:channels name="新闻" columns="2" width="90%" border="0" cellpadding="2"> 
    <stl:image border="0"></stl:image> 
    <stl:a><stl:channel type="title"></stl:channel></stl:a> 
</stl:channels> 
</pre>

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

[[category:SiteServer|S]]