stl:contents 内容列表

通过 stl:contents 标签在模板中显示内容列表

stl:contents 标签用法

内容列表

<stl:contents
	align="整体对齐"
	cellPadding="填充"
	cellSpacing="间距"
	channelIndex="栏目索引"
	channelName="栏目名称"
	class="Css类"
	columns="列数"
	direction="方向"
	group="指定显示的内容组"
	groupChannel="指定显示的栏目组"
	groupChannelNot="指定不显示的栏目组"
	groupContent="指定显示的内容组"
	groupContentNot="指定不显示的内容组"
	groupNot="指定不显示的内容组"
	height="整体高度"
	isColor="仅显示醒目内容"
	isDynamic="是否动态显示"
	isFile="仅显示附件内容"
	isHot="仅显示热点内容"
	isImage="仅显示图片内容"
	isNoDup="不显示重复标题的内容"
	isRecommend="仅显示推荐内容"
	isRelatedContents="显示相关内容列表"
	isTop="仅显示置顶内容"
	isVideo="仅显示视频内容"
	itemAlign="项水平对齐"
	itemClass="项Css类"
	itemHeight="项高度"
	itemVerticalAlign="项垂直对齐"
	itemWidth="项宽度"
	layout="指定列表布局方式"
	order="排序"
	scope="内容范围"
	startNum="从第几条信息开始显示"
	tags="指定标签"
	titleWordNum="内容标题文字数量"
	topLevel="从首页向下的栏目级别"
	totalNum="显示内容数目"
	upLevel="上级栏目的级别"
	where="获取内容列表的条件判断"
	width="整体宽度"
></stl:contents>

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

属性列表

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

属性 可能的取值 默认值 简介
channelIndex     栏目索引
channelName     栏目名称
upLevel     显示上几级栏目的内容列表,0为本级,1为父栏目,以此类推。
topLevel     显示从首页向下某个级别栏目的内容列表,0代表网站首页,1代表一级栏目,以此类推。
scope     内容范围。此属性只可属于以下可能的取值的一种。
  Self 只显示本栏目下的所有内容
  Children   只显示下一极子栏目下的所有内容
  SelfAndChildren   显示本级栏目及下一极子栏目下的所有内容
  Descendant   显示所有级别的子栏目下的所有内容
  All   显示全部内容
groupChannel     栏目组别,如设置此属性,则只显示指定栏目组别的内容列表。
groupChannelNot     非栏目组别,如设置此属性,则只显示不等于指定栏目组别的内容列表。
groupContent     内容组别,如设置此属性,则只显示指定内容组别的内容列表。
groupContentNot     非内容组别,如设置此属性,则只显示不等于内容组别的内容列表。
tags     仅显示指定标签的内容列表,多个标签用","分隔。
isTop     是否只显示置顶(非置顶)内容。
  true   仅显示置顶的内容
  false   仅显示非置顶的内容
isRecommend     是否只显示推荐(非推荐)内容。
  true   仅显示推荐的内容
  false   仅显示非推荐的内容
isHot     是否只显示热点(非热点)内容。
  true   仅显示热点的内容
  false   仅显示非热点的内容
isColor     是否只显示醒目(非醒目)内容。
  true   仅显示醒目的内容
  false   仅显示非醒目的内容
totalNum     设置列表一共显示多少条信息,0代表显示所有信息。
startNum   1 从第几条信息开始显示,默认从第一条信息开始显示。
titleWordNum     设置内容标题显示的字数,0代表不限制字数。
order     内容列表排序方式。此属性只可属于以下可能的取值的一种。
  Default 默认排序,即内容管理界面中的排序
  Back   默认排序的相反方向
  AddDate   按添加时间排序
  AddDateBack   按添加时间的相反方向排序
  LastEditDate   按最后更改时间排序
  LastEditDateBack   按最后更改时间的相反方向排序
  Hits   按点击量排序
  HitsByDay   按日点击量排序
  HitsByWeek   按周点击量排序
  HitsByMonth   按月点击量排序
  Stars   按评分数排序
  Digg   按点评数排序
  Comments   按评论数排序
  Random   随机显示内容
isImage     是否只显示带有图片(不带图片)的内容。
  true   仅显示带有图片的内容
  false   仅显示不带图片的内容
isVideo     是否只显示带有视频(不带视频)的内容。
  true   仅显示带有视频的内容
  false   仅显示不带视频的内容
isFile     是否只显示带有附件(不带附件)的内容。
  true   仅显示带有附件的内容
  false   仅显示不带附件的内容
isNoDup     不显示重复标题的内容
  true   不显示重复标题的内容
  false 显示重复标题的内容
isRelatedContents     是否显示相关内容列表
  true   显示相关内容列表
  false 不显示相关内容列表
where     获取内容列表的条件判断
cellPadding     填充像素值
cellSpacing     间距像素值
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   不设置
isDynamic     是否动态显示
  true   动态显示
  false 静态显示

注意

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

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

使用 isNoDup="true" 属性,系统将判断标题时候重复,重复标题的内容只显示一次。

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

<stl:contents>标签对应的实体为{stl:contents}