stl:sites 获取站点列表

站点列表

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

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

属性列表

下表显示所有属于此元素的属性列表。

属性 可能的取值 默认值 简介
siteName     站点名称
directory     站点文件夹
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或directory属性,系统将从对应站点的子站点中选择,否则系统将从所有站点中选择。

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

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

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

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

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