stl:sites 标签用法

站点列表

<stl:sites
	align="整体对齐"
	cellPadding="填充"
	cellSpacing="间距"
	class="Css类"
	columns="列数"
	direction="方向"
	height="整体高度"
	isDynamic="是否动态显示"
	itemAlign="项水平对齐"
	itemClass="项Css类"
	itemHeight="项高度"
	itemVerticalAlign="项垂直对齐"
	itemWidth="项宽度"
	layout="指定列表布局方式"
	order="排序"
	scope="范围"
	since="时间段"
	siteName="站点名称"
	siteDir="站点文件夹"
	startNum="从第几条信息开始显示"
	totalNum="显示内容数目"
	where="获取站点列表的条件判断"
	width="整体宽度"
></stl:sites>

获取站点列表并显示在页面上。

属性列表

下表显示所有属于此标签的属性列表。

属性	可能的取值	默认值	简介
siteName			站点名称
siteDir			站点文件夹
totalNum			设置列表一共显示多少个站点，不设置将显示所有站点。
startNum		1	从第几个站点开始显示，默认从第一个站点开始显示。
scope			站点显示范围。此属性只可属于以下可能的取值的一种。
	Children		显示下级站点的列表
	Descendant		显示下级及下下级站点的列表
	All		显示所有站点的列表
order			站点列表排序方式。
	Default		默认排序，显示与CMS后台站点相同的排序
	Contents		按站点中内容数进行排序
	Hits		按站点中页面的点击量进行排序
since			时间段，格式为"数字+日期符号"，日期符号有"y"、"m"、"d"及"h"，分别代表年、月、天及小时。
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类
isDisplayIfEmpty			当项为零是是否显示。
	true		列表项不存在时仍然显示
	false		列表项不存在时不显示
class			整体CSS类
target			控制链接打开窗口的目标
height			列表的整体高度
width			列表的整体宽度
align			列表的整体对齐方式
	Center		居中对齐
	Left		居左对齐
	Right		居右对齐
	Justify		向页面的左右边缘对齐
	NotSet		不设置
cellpadding			填充像素值
cellspacing			间距像素值
isDynamic			是否动态显示
	true		动态显示
	false		静态显示

注意

标签 <stl:sites> 用于显示网站群中的站点，如果定义siteName或siteDir属性，系统将从对应站点的子站点中选择，否则系统将从所有站点中选择。

<stl:sites> 必须包含子标签，否则将不起作用，系统将找到对应的站点并在对应站点下解析子标签。子标签可以是任意STL标签或HTML标签。

属性 order 用于站点列表排序：

• order 不设置或设置为"Default"，站点列表将与CMS后台中站点的显示排序一致。
• order 设置为"Contents"，站点将根据内容数的多少进行排序，如果同时设置since属性，系统将根据对应时间段内添加的内容数量进行排序。
• order 设置为"Hits"，站点将根据页面点击量的多少进行排序，如果同时设置since属性，系统将根据对应时间段内页面浏览量的数量进行排序。

属性 since 用于指定时间段，列表将只显示这段时间内添加的站点。since 属性格式为"数字+日期符号"，如"1y"、"3m"、"10d"或"16h"，分别代表一年、三个月、十天及十六个小时。

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