编辑“YulinCMS CateList标签说明”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[YulinCMS|上一页]]</span>
<div style="clear:both;"></div>
==功能说明==
用于获取栏目列表

==适用范围==
所有模板

==语法格式==
<pre>
 {Yu:CateList 属性1="属性值1" 属性2="属性值2" ......}
 {NormalTemplate} 普通项模板 + 底层变量......{/NormalTemplate}   // 普通项模板元素
 {AlterTemplate} 交替项模板 + 底层变量......{/AlterTemplate}   // 交替项模板元素（可选）
 {SeparTemplate} 分隔符模板......{/SeparTemplate}   // 分隔符模板元素（可选）
 {ConditionTemplate} 条件输出模板......{/ConditionTemplate}   // 条件输出模板元素（可选）
 {/Yu:CateList}
</pre>

==模板元素==	
*'''NormalTemplate''' 在栏目列表中的每一行都呈现一次的[[模板]]元素。
*'''AlterTemplate ''' 与 NormalTemplate 元素类似，但在栏目列表中隔行（交替项）呈现一次。通过设置 AlterTemplate 元素的内容，可以为其指定不同的外观。
*'''SeparTemplate'''  将呈现在栏目列表行之间。如果不设置，则不呈现分隔符内容。
*'''ConditionTemplate '''栏目数量达到 num 的倍数时，输出该模板元素的内容（num 为标签属性 Condition 指定的数字值）
'''备注：'''如果没有使用任何模板元素，则标签中的内容被默认为 NormalTemplate 普通项模板的内容

==标签属性==	
*'''Count''' 显示栏目个数 （不指定则显示所有栏目）

*'''Cate''' 指定栏目ID，显示其子栏目。
属性值可以是
#'''Top''' 表示顶级栏目列表。
#'''Child '''表示子栏目列表。（用于栏目页、内容页）
#'''Self''' 表示同级栏目列表。（用于栏目页、内容页）
#'''Id''' 调用外层列表标签指定的栏目
调用指定栏目组的栏目 例如：Cate="12"
不指定该属性则忽略该条件

*'''CateGroup''' 栏目组别
属性值可以是

'''Rand''' 调用任意一个栏目组别的栏目

调用指定栏目组的栏目 例如：CateGroup="1"

调用多个指定栏目组的栏目 例如 CateGroup="2|3|5"

如设置此属性，则只显示栏目组别等于 CateGroup 的栏目列表。不指定该属性则忽略该条件

*'''CateGroupNot''' 非栏目组别
属性值可以是

'''Rand''' 调用任意一个栏目组外的栏目
调用除指定栏目组外的栏目 例如：CateGroupNot="1"

如设置此属性，则只显示栏目组不等于 CateGroupNot 的栏目列表。不指定该属性则忽略该条件

*'''Start''' 调用栏目时的起始位置，和 Count 配合使用
例如: {Yu:CateList Count="5" Start="5"}.......{/Yu:CateList}

上面例子正好调用了 从第5条 -- 第10条记录之间的 5条 记录

*'''Cols''' 栏目显示列数
例如： Cols="2"

不指定该属性则默认列数为1

*'''TableStyle''' 列表表格的样式，表示 <table 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。

*'''TrStyle''' 列表表格的行样式，表示 <tr 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。

*'''TdStyle''' 列表表格的单元格样式,表示 <td 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。

*'''Condition''' 条件输出
例如 Condition="num"

num为数字。当内容数量达到 num 的倍数时，输出 ConditionTemplate 模板元素的内容。

*'''IntroLen''' 栏目介绍显示字符数量
不指定该属性则默认显示完整的内容

*'''IntroAddStr''' 栏目介绍超出部分显示的省略字串
例如: IntroAddStr ="..."

不指定该属性则默认为不追加任何省略字串

*'''NormalTemplateName''' 普通项模板名称

*'''AlterTemplateName''' 交替项模板名称

*'''SeparTemplateName''' 分隔符模板名称

*'''ConditionTemplateName''' 条件输出模板名称

==底层变量==
*'''{@AutoId/}''' 自动Id。按照递增方式自动产生Id，从 1 开始。通常用来表示行号。
*'''{@Id/}''' 栏目ID
*'''{@Title/} 栏目名字
*'''{@PicPath/}''' 栏目标题图片
*'''{@SPicPath_1/}''' 标题缩略图 （1级 大小 300*200）
*'''{@SPicPath_2/}''' 标题缩略图 （2级 大小 150*100）
*'''{@SPicPath_3/} '''标题缩略图 （3级 大小 90*60）
*'''{@Target/} '''栏目链接打开方式
*'''{@Intro/} '''栏目介绍
*'''{@CatePath/} '''栏目路径
*'''{@RssPath/} '''栏目[[Rss]]路径
*'''{@ContTotal/} '''栏目下内容总数
*'''{@CateTotal/} '''子栏目总数
*'''{@AddTime/}''' 栏目创建时间

==使用示例==
查看[[YulinCMS CateList标签调用示例|CateList标签的使用示例]]

==相关条目==
*[[锐商CMS]]
*[[PageAdmin]]
*[[Umbraco]]
*[[DedeCMS]]
*[[帝国CMS]]
*[[Drupal]]
*[[YulinCMS PageVar标签说明]]

==参考来源==
*[http://help.yulincms.com/ 参考来源]

[[category:YulinCMS|C]]