stl:channels 栏目列表

栏目列表

<stl:channels cellPadding="填充" cellSpacing="间距" class="Css类" columns="列数" direction="方向" layout="指定列表布局方式" height="整体高度" width="整体宽度" align="整体对齐" itemHeight="项高度" itemWidth="项宽度" itemAlign="项水平对齐" itemVerticalAlign="项垂直对齐" itemClass="项Css类" groupChannel="指定显示的栏目组" groupChannelNot="指定不显示的栏目组" totalNum="显示栏目数目" startNum="从第几条信息开始显示" order="排序" isImage="仅显示图片栏目" isDisplayIfEmpty="当项为零是是否显示" where="获取栏目列表的条件判断" isDynamic="是否动态显示" channelIndex="栏目索引" channelName="栏目名称" upLevel="上级栏目的级别" topLevel="从首页向下的栏目级别" isTotal="是否从所有栏目中选择" isAllChildren="是否显示所有级别的子栏目"></stl:channels>

stl:channels是列表标签,用于栏目列表循环。
channelIndex="栏目索引",channelName="栏目名称",parent="显示父栏目属性",upLevel="上级栏目的级别"以及topLevel="从首页向下的栏目级别"用于定位到具体的栏目。

属性列表

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

属性 可能的取值 默认值 简介
channelIndex     栏目索引
channelName     栏目名称
upLevel     显示上几级栏目的下级栏目列表,0为显示下级栏目列表,1为显示同级栏目列表,2为显示父栏目的同级栏目列表,以此类推。
topLevel     显示从首页向下某个级别栏目的下级栏目列表,0代表网站首页,1代表一级栏目,以此类推。
isTotal     是否从所有栏目中选择(包括首页)
  true   从网站的所有栏目中选择合适的栏目进行显示
  false 不从所有栏目总选择
isAllChildren     是否显示所有级别的子栏目
  true   显示所有级别的子栏目
  false 只显示子栏目,不包括子栏目的子栏目。
isImage     是否只显示带有图片的栏目。此属性只可属于以下可能的取值的一种。
  true   只显示带有图片的栏目
  false 显示所有的栏目
isDisplayIfEmpty     当栏目列表项不存在时是否仍然显示
  true   栏目列表项不存在时仍然显示
  false 栏目列表项不存在时不显示
groupChannel     栏目组别,如设置此属性,则只显示栏目组别等于group的栏目列表。
groupChannelNot     非栏目组别,如设置此属性,则只显示栏目组别不等于group的栏目列表。
order     栏目列表排序方式。此属性只可属于以下可能的取值的一种。
  Default 默认排序,即栏目管理界面中的排序
  Back   默认排序的相反方向
  AddDate   按添加时间排序
  AddDateBack   按添加时间的相反方向排序
  Hits   按点击量排序
  Random   随机显示栏目
totalNum     设置列表一共显示多少条信息,0代表显示所有信息。
startNum   1 从第几条信息开始显示,默认从第一条信息开始显示。
titlewordnum   栏目名称文字数量。
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 静态显示

注意

columnsdirection 以及 layout 属性用于控制生成列表的HTML 标签。
columns 控制生成列表的列数,direction 控制生成列表的方向,layout 控制生成列表的HTML元素。
layout 为Table时系统使用<table>标签生成列表,layout 为Flow时系统使用<span>标签生成列表,默认为None,即仅循环列表项。

groupChannel 属性及 groupChannelNot 属性用于筛选需要显示的栏目。

如果设置了 channelIndex 属性,系统将寻找对应此栏目索引的栏目并对子栏目进行循环显示。
如果设置了 channelName 属性,系统将寻找对应此栏目名称的栏目并对子栏目进行循环显示。
如果设置了 parentupLevel 属性,系统将寻找上级或上几级的栏目并对子栏目进行循环显示。
如果设置了 topLevel 属性,系统将寻找从首页向下的栏目级别并对子栏目进行循环显示。
如果以上属性都未设置,系统将寻找当前栏目并对子栏目进行循环显示。

<stl:channels>元素对应的实体为{stl:channels}