# 1\. 栏目列表 xy:channel
{xy:channel \[属性=值 属性=值\]}\[field.\*/\]{/xy:channel}
栏目的排序会根据后台栏目信息的排序字段决定
> 适用范围：适用于网站顶部以获取站点栏目信息
标签格式
```
{xy:channel}
[field.*/]
{/xy:channel}
```
嵌套格式
```
{xy:channel type=nav ref=one}
[field.typetitle/] <br>
{xy:channel refs=one ref=two}
[field.typetitle/]<br>
{xy:channel refs=two}
[field.typetitle/]<br>
{/xy:channel}
{/xy:channel}
{/xy:channel}
```
标签嵌套采用ref定义、refs引用的方式，以上代码显示三层栏目结构
> 标签属性
| **名称** | **类型** | **必须** | **示例值** | **默认值** | **描述** |
| --- | --- | --- | --- | --- | --- |
| type | 字符串 | 否 | son top level self | son | **son**:取下级栏目；**top**:取顶级栏目;**level**:取同级栏目；**self**:取当前栏目； **nav**:该标签用于首页导航取第一级栏目;**path**:取当前栏目的路径，通常用于详情页，显示隶属栏目位置，例如：新闻中心 > 行业新闻；**parent**:上一级栏目； |
| typeid | 整型 | 否 | \>0 | 所有父级栏目 | typeid有值时，取所指栏目的子级 |
| size| 整型 | 否 | \>0 | 返回既定条件下的栏目个数，不使用则默认返回全部 |
| flag| 字符串| 否 | | 在自定义字典中定义好对应的值，具体属性值请在栏目属性进行查看，使用方式参考文章列表的flag使用 |
| noflag | 字符串 | 否 | | 参考文章列表的noflag |
| orderby | 字符串 | 否 | | 栏目排序,sort排序需要在自定义顺序设置才能看到效果 |
| order| 字符串 | 否 | | desc:按照倒序排列，asc:按照正序排列 |
可包含字段\[field.\*/\]
| 字段名称 | 描述 |
| --- | --- |
| \[field.typeindex/\] | 序号，根据显示条数显示的序号1 2 …..10 |
| \[field.typetitle/\] | 栏目名称，与栏目链接一起使用 |
| \[field.typeshorttitle/\] | 栏目副标题|
| \[field.typelink/\] | 栏目链接：\[field.typelink/\] |
| \[field.typekeyword/\] | 栏目关键字 |
| \[field.typedescrip/\] | 栏目描述 |
| \[field.typeid/\] | 栏目id |
| \[field.class/\] | 当前选中的栏目应用的样式 |
| \[field.typelitpic/\] | 栏目缩略图：\[field.typelitpic/\] |
给动态获取的标题在选中时添加detailMainLeftMenu\_cur样式
```
<style>.detailMainLeftMenu_cur{color:#fff}</style>
<ul>
{xy:channel type=son class=detailMainLeftMenu_cur}
<li><a href="{xy:global.url/}[field.typelink/]"class="[field.class/]">[field.typetitle/]</a></li>
{/xy:channel}
</ul>
```
栏目标签完整范例
```
<div class="">
{xy:channel}
<div class="">
<ul>
<li><a href="{xy:global.url/}[field.typelink/]">[field.typetitle/]</a></li>
</ul>
</div>
{/xy:channel}
</div>
```
