Siteserver-stl:channels栏目列表

导航: 上一页

stl:channels 栏目列表

在模板中插入栏目的列表

属性列表

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

的成员均适用于<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		按点击量排序
totalNum			设置列表一共显示多少条信息，0代表显示所有信息。
startNum		1	从第几条信息开始显示，默认从第一条信息开始显示。
titleWordNum			设置栏目标题显示的字数，0代表不限制字数
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时系统使用标签生成列表，layout为Flow时系统使用标签生成列表，默认为None，即仅循环列表项。
  • titleWordNum属性控制生成列表中标题文字的显示字数，作用于<stl:channel type="title">。

  
  stl:channels 示例

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

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

      
  <stl:channels name="新闻"></stl:channels>   
   
  <stl:channels name="新闻"></stl:channels> 
  

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

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

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

  • 示例三：列表显示两列

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

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

  参考资料

  • SiteServer官方