# 栏目标签
描述:输出栏目导航数据
| 额外参数 | 说明 |必须|
| --- | --- |--- |
| @catid | 栏目列表id,列表页,内容页可以使用 $catid 获取当前栏目, 为0代表输出顶级栏目 |是 |
| @order| 排序,例如“id DESC” |否|
| @limit| 指定返回数据量 例如limit="5,10",且不得和@num共存 |否 |
| @num| 每次返回数据量 例如num="5" |否 |
| @where| sql语句的where部分 例如:thumb != '' AND status = 1|否|
简单示例:
```
{yzn module="cms" action="category" catid="0" cache="3600" order="listorder ASC" num="10" return="data"}
{volist name="data" id="vo"}
...HTML...
{/volist}
{/yzn}
```
完整示例:
```
//输出顶级栏目和二级栏目10条数据并且缓存3600秒
<div class="nav fr">
<ul class="navlist">
<li {if !isset($catid)}class="hover"{/if}><a href="{:url('cms/index/index')}" title="首页">首页</a></li>
{yzn module="cms" action="category" catid="0" cache="3600" order="listorder ASC" num="10" return="data"}
{volist name="data" id="vo"}
<li {if isset($catid) && in_array($catid,explode(',',$vo['arrchildid']))}class='hover'{/if}>
<a href="{$vo.url}" title="{$vo.catname}">{$vo.catname}</a>
<!--判断是否有子栏目-->
{eq name="vo.child" value="1"}
<div class="subnav">
{yzn module="cms" action="category" catid="$vo['id']" cache="3600" order="listorder ASC" num="10" return="data"}
{volist name="data" id="vo"}
<a href="{$vo.url}" title="{$vo.catname}">{$vo.catname}</a>
{/volist}
{/yzn}
</div>
{/eq}
</li>
{/volist}
{/yzn}
</ul>
</div>
```
| 返回变量 |说明 |
| --- | --- |
| @id | 栏目id |
| @catid | 栏目列表id |
| @url | 栏目url路径 |
| @catdir | 唯一标识 |
| @catname| 栏目名称 |
| @image | 栏目图片 |
| @description | 栏目描述 |
| @child| 是否含有子栏目 0-无 1-有 |
| @arrchildid | 所有子栏目 |
| @parentid| 上级父栏目 |
| @arrparentid | 所有父栏目 |
| @modelid | 模型ID |
| @type | 栏目类型ID 0-列表 1-单页 2-外链 |
| @listorder | 排序 |
| @status | 状态 0-隐藏 1-显示 |
- 序言
- 环境搭建
- 目录结构
- 系统配置
- 系统函数&类
- thumb(函数)
- fun(函数)
- get_file_path(函数)
- email(类)
- 插件使用说明
- cms插件
- 变量/常量
- 函数
- 标签
- 公共参数
- 栏目标签
- 列表标签
- 内容详情页
- 上一页标签
- 下一页标签
- Tags标签
- 万能标签
- 原生标签
- 模板
- 使用技巧
- 阅读收费
- 会员插件
- 常见问题
- 表单插件
- 调用方式
- 模板
- 短信插件
- 友情链接插件
- 标签
- 常见问题
- URL重写
- 如果设置插件为首页默认打开
- 百度编辑器多图片上传被压缩
- 各类服务器使用注意事项
- 部分虚拟机隐藏index.php有问题
- composer
- composer简介
- 内置composer
- 各大厂商镜像地址
- 常用命令