# 栏目标签
描述:输出栏目导航数据
| 额外参数 | 说明 |必须|
| --- | --- |--- |
| @catid | 为0代表输出顶级栏目,指定id则输出该id下的子栏目 |是 |
| @order| 排序,例如“id DESC” |否|
| @limit| 指定返回数据量 例如limit="5,10",且不得和@num共存 |否 |
| @num| 每次返回数据量 例如num="5" |否 |
| @where| sql语句的where部分 例如:`where="id in(1,6,8)"`,代表输出id1,6,8的栏目,@catid参数则需要省略|否|
简单示例:
```
{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 |
| @url | 栏目url路径 |
| @catdir | 唯一标识 |
| @catname| 栏目名称 |
| @image | 栏目图片 |
| @icon | 栏目图标 |
| @description | 栏目描述 |
| @child| 是否含有子栏目 0-无 1-有 |
| @arrchildid | 所有子栏目 |
| @parentid| 上级父栏目 |
| @arrparentid | 所有父栏目 |
| @modelid | 模型ID |
| @type | 栏目类型ID 1-单页 2-列表 3-外链 |
| @listorder | 排序 |
| @status | 状态 0-隐藏 1-显示 |
- 与1.4版本差异说明
- 序言
- 使用条款
- 安装
- 环境搭建
- 事件
- 表单生成
- 数据限制
- 命令行
- 一键生成CRUD
- 一键生成菜单
- 一键安装
- 一键压缩打包
- 系统配置
- 常规字段
- 特殊字段1:高级下拉框[selectpage]
- 特殊字段2:自定义字段
- 特殊字段3:自定义多图片
- 邮箱/短信类
- 前端&组件
- 后台前端框架
- 文件上传
- table数据表格
- auth权限验证
- 动态显示(Favisible)
- 动态下拉(SelectPage)
- 键值组件(Fieldlist)
- 标签输入
- uniapp教程
- 🔥插件使用说明
- cms内容管理【cms】
- 变量/常量
- 函数
- getCategory - 栏目获取
- catpos - 面包屑
- seo - 生成SEO
- buildCatUrl - 生成栏目URL
- buildContentUrl - 创建内容链接
- 标签
- 公共参数
- 栏目标签
- 列表标签
- 上一页标签
- 下一页标签
- Tags标签
- 万能标签
- 原生标签
- 搜索页
- 筛选页
- 内容详情页
- 模板
- 技巧/问题
- 敏感词检测
- 栏目授权不全
- 循环表格
- 部分虚拟主机tags页面报错
- 内容页分页
- 分页伪静态
- 实现电脑和手机模板分离
- 阅读收费
- 友情链接【links】
- 自定义表单【formguide】
- 调用方式
- 支付插件【pay】
- 支付宝
- 微信
- 万能采集【collection】
- 采集列表规则
- 采集内容规则
- 关于图片
- H5设计【diywap】
- 接口文档【apidoc】
- 返回顶部【returntop】
- 通用数据导出【dataoutput】
- 通用数据导入【dataimport】
- 多通道短信【easysms】
- 塞邮邮箱【saiyouems】
- 第三方登录【synclogin】
- 中文分词【getwords】
- QQ客服【kefu】
- 地图位置【address】
- 智能人机验证【vaptcha】
- 数据转换【v9toyzn】
- 数据转换【dedetoyzn】
- 百度收录查询【baidurecord】
- 蜘蛛访问统计【spider】
- editormd编辑器【editormd】
- Easymde编辑器【easymde】
- 百度ueditor插件【ueditor】
- 敏感词检测【sensitive】
- 邮箱发送【phpmailer】
- 内容收藏【favorite】
- 队列插件【queue】
- 七牛云【qiniu】
- 阿里云oss【alioss】
- 腾讯云【cos】
- 迅搜全文检索【xunsearch】
- 评论插件【comments】
- 会员邀请【invite】
- 快递查询插件【expressquery】
- 礼品卡提货系统【pickup】
- 地区插件【area】
- IP归属地查询【ipregion】
- 百度统计插件【baidutongji】
- 消息通知【notice】
- 微信管理【wechat】
- 在线投票系统【vote】
- 图片处理【imgproc】
- 后台登录主题【adminlogin】
- 文档管理系统【docs】
- 频率限制【throttle】
- 2FA双因子验证【twofas】
- 🔥开发者入驻
- 申请入驻
- 建立私库
- 插件入驻流程
- 模板入驻流程
- 🔥插件开发
- 目录结构
- 数据库
- 测试数据
- 插件信息
- 插件配置
- 核心文件
- 插件函数
- 常见问题
- YznCMS开发遇到错误怎么办?(新手必看)
- 开启调试模式
- 伪静态(URL重写)
- 如何去除访问链接中的index.php
- 各类虚拟主机伪静态使用注意事项
- 如何自定义404页面显示模板
- 管理员登录时提示请于1天后再尝试登录
- 宝塔面板一键部署
- 后台登录时验证码不显示
- 后台密码忘记重置方法
- 关于编辑器的一些说明
- 如何重置后台登录地址
- 如何修改或禁用左侧菜单栏的角标
- composer
- composer简介
- 内置composer
- 常用命令
- 参考文档
- 安全建议
- 更新日记和补丁包