stl:channels 标签用法
栏目列表
<stl:channels align="整体对齐" cellPadding="填充" cellSpacing="间距" channelIndex="栏目索引" channelName="栏目名称" class="Css类" columns="列数" direction="方向" groupChannel="指定显示的栏目组" groupChannelNot="指定不显示的栏目组" height="整体高度" isAllChildren="是否显示所有级别的子栏目" isDynamic="是否动态显示" isImage="仅显示图片栏目" isTotal="是否从所有栏目中选择" itemAlign="项水平对齐" itemClass="项Css类" itemHeight="项高度" itemVerticalAlign="项垂直对齐" itemWidth="项宽度" layout="指定列表布局方式" order="排序" startNum="从第几条信息开始显示" topLevel="从首页向下的栏目级别" totalNum="显示栏目数目" upLevel="上级栏目的级别" where="获取栏目列表的条件判断" width="整体宽度" ></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 | 显示所有的栏目 | ||
groupChannel | 栏目组别,如设置此属性,则只显示栏目组别等于group的栏目列表。 | ||
groupChannelNot | 非栏目组别,如设置此属性,则只显示栏目组别不等于group的栏目列表。 | ||
order | 栏目列表排序方式。此属性只可属于以下可能的取值的一种。 | ||
Default | 默认排序,即栏目管理界面中的排序 | ||
Back | 默认排序的相反方向 | ||
AddDate | 按添加时间排序 | ||
AddDateBack | 按添加时间的相反方向排序 | ||
Hits | 按点击量排序 | ||
Random | 随机显示栏目 | ||
totalNum | 设置列表一共显示多少条信息,0代表显示所有信息。 | ||
startNum | 1 | 从第几条信息开始显示,默认从第一条信息开始显示。 | |
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 | 静态显示 |
注意
columns
、direction
以及 layout
属性用于控制生成列表的HTML 标签。
columns
控制生成列表的列数,direction
控制生成列表的方向,layout
控制生成列表的HTML标签。
layout
为Table时系统使用<table>标签生成列表,layout
为Flow时系统使用<span>标签生成列表,默认为None,即仅循环列表项。
groupChannel
属性及 groupChannelNot
属性用于筛选需要显示的栏目。
如果设置了 channelIndex
属性,系统将寻找对应此栏目索引的栏目并对子栏目进行循环显示。
如果设置了 channelName
属性,系统将寻找对应此栏目名称的栏目并对子栏目进行循环显示。
如果设置了 parent
或 upLevel
属性,系统将寻找上级或上几级的栏目并对子栏目进行循环显示。
如果设置了 topLevel
属性,系统将寻找从首页向下的栏目级别并对子栏目进行循环显示。
如果以上属性都未设置,系统将寻找当前栏目并对子栏目进行循环显示。
<stl:channels>
标签对应的实体为{stl:channels}
。