# <stl:sites> 站点列表

<stl:sites
    siteName="站点名称"
    siteDir="站点文件夹"
    scope="站点范围"
    totalNum="显示站点数目"
    startNum="从第几条信息开始显示"
    order="排序"
    where="条件判断"
    layout="布局"
    columns="列数"
    direction="方向"
    height="整体高度"
    width="整体宽度"
    align="整体对齐"
    itemHeight="项高度"
    itemWidth="项宽度"
    itemAlign="项水平对齐"
    itemVerticalAlign="项垂直对齐"
    itemClass="项Css类">
</stl:sites>

# 说明

通过 stl:sites 标签在模板中显示站点列表

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

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

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

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

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

# 属性

TIP

所有属于 HTML 标签<table>的成员均适用于<stl:sites>标签。

属性	说明
siteName	站点名称
siteDir	站点文件夹
scope	站点范围
totalNum	显示站点数目
startNum	从第几条信息开始显示
order	排序
where	条件判断
layout	布局
columns	列数
direction	方向
height	整体高度
width	整体宽度
align	整体对齐
itemHeight	项高度
itemWidth	项宽度
itemAlign	项水平对齐
itemVerticalAlign	项垂直对齐
itemClass	项Css类

# siteName - 站点名称

如果设置了 siteName 站点名称属性，标签将只显示此站点的下级站点列表。

# siteDir - 站点文件夹

如果设置了 siteDir 站点文件夹属性，标签将只显示此站点的下级站点列表。

# scope - 站点范围

此属性只可属于以下可能的取值的一种。

"children" 显示下级站点的列表
"descendant" 显示下级及下下级站点的列表
"all" 显示所有站点的列表

# totalNum - 显示站点数目

设置列表一共显示多少条信息，默认值为 0，代表显示所有信息。

<stl:sites totalNum="7">
  <stl:site type="siteName"></stl:site><br />
</stl:sites>

# startNum - 从第几条信息开始显示

设置列表从第几条信息开始显示，默认值为 1，代表从第一条信息开始显示。

<stl:sites startNum="3" totalNum="7">
  <stl:site type="siteName"></stl:site><br />
</stl:sites>

# order - 排序

站点列表排序方式。

"default" 默认排序，显示与 CMS 后台站点相同的排序
"contents" 按站点中内容数进行排序
"hits" 按站点中页面的点击量进行排序

# where - 条件判断

获取站点列表的条件判断。

# layout - 布局

列表布局属性用于控制列表循环中每一项的显示方式，默认值为 none，即直接循环，不控制列表项显示。

"none" 列表不使用布局，仅循环列表项，不控制列表项显示。此值是默认的，如果没有指定属性的话。
"table" 列表使用表格布局，系统将把列表标签解析为 HTML <table> 元素，table 标签的所有属性（class、style、cellPadding、cellSpacing 等）均可用在列表标签中。

<stl:sites layout="table" columns="3" width="90%" border="0" cellpadding="2">
    <stl:site type="siteName"></stl:site>
</stl:sites>

# columns - 列数

columns 属性决定要显示的列的数量。比如，如果要在列表中显示四列的项，那么可以把这个属性设为 4。

<stl:sites layout="table" columns="3" width="90%" border="0" cellpadding="2">
    <stl:site type="siteName"></stl:site>
</stl:sites>

WARNING

columns 属性只有当列表布局为表格 layout="table" 时才起作用。

# direction - 方向

direction 属性用于确定列表是按水平方向还是或垂直方向来重复。

"vertical" 垂直
"horizontal" 水平

如果将此属性设置为 vertical，列表中的项显示在从上到下加载的列中，然后从左到右，直到呈现所有项。例如，如果将 columns 属性设置为 3，列表中的项显示在三列中，如下表所示。

1	4	7
2	5	8
3	6	9

如果将此属性设置为 horizontal，列表中的项以从左到右加载的行显示，然后从上到下，直到呈现所有项。例如，如果将 columns 属性设置为 3，列表的项将以每行三项的形式显示，如下表所示。

1	2	3
4	5	6
7	8	9

TIP

即使 direction 值为 vertical，还是显示为 4 个列。columns 永远是指重复的列的数量，而不是行的数量。

WARNING

direction 属性只有当列表布局为表格 layout="table" 且设置了列数 columns 时才起作用。

# height - 整体高度

设置列表的整体高度。

WARNING

height 属性只有当列表布局为表格 layout="table" 时才起作用。

# width - 整体宽度

设置列表的整体宽度。

WARNING

width 属性只有当列表布局为表格 layout="table" 时才起作用。

# align - 整体对齐

设置列表的整体对齐方式。

"center" 居中对齐。
"left" 居左对齐。
"right" 居右对齐。
"justify" 向页面的左右边缘对齐。
"notSet" 不设置。此值是默认的，如果没有指定属性的话。

WARNING

align 属性只有当列表布局为表格 layout="table" 时才起作用。

# itemHeight - 项高度

列表中每一项的高度。

WARNING

itemHeight 属性只有当列表布局为表格 layout="table" 时才起作用。

# itemWidth - 项宽度

列表中每一项的宽度。

WARNING

itemWidth 属性只有当列表布局为表格 layout="table" 时才起作用。

# itemAlign - 项水平对齐

列表中每一项的水平对齐方式。

"center" 居中对齐。
"left" 居左对齐。
"right" 居右对齐。
"justify" 向页面的左右边缘对齐。
"notSet" 不设置。此值是默认的，如果没有指定属性的话。

WARNING

itemAlign 属性只有当列表布局为表格 layout="table" 时才起作用。

# itemVerticalAlign - 项垂直对齐

列表中每一项的垂直对齐方式。

"top" 顶端对齐。
"middle" 居中对齐。
"bottom" 底端对齐。
"notSet" 不设置。此值是默认的，如果没有指定属性的话。

WARNING

itemVerticalAlign 属性只有当列表布局为表格 layout="table" 时才起作用。

# itemClass - 项Css类

列表中每一项的Css类名称。

WARNING

itemClass 属性只有当列表布局为表格 layout="table" 时才起作用。

# 示例

# 显示当前站点的下级站点列表

下面的例子显示当前站点的下级站点列表。

<stl:sites>
    <li><stl:site type="siteName"></stl:site></li>
</stl:sites>