描述:输出栏目导航数据
| 额外属性 | 说明 | 必须 |
| --- | --- | --- |
| cid | 栏目列表id,列表页,内容页可以使用 $cid 获取当前栏目, 为0代表输出顶级栏目 | 是 |
| order | 排序,例如 id desc asc | 否 |
| limit | 指定返回数据量 例如limit="5,10",且不得和@num共存 | 否 |
| num | 每次返回数据量 例如num="5" | 否 |
| where | sql语句的where部分 例如:id = '1' AND status = 1 | 否 |
> 导航标签,参数cid=0只获取顶级导航,去掉获取全部,loop参数=1表示自动加入volist循环标签,如果值是0,必须加入volist或者foreach循环渲染的标签,获取当前ID变量为 $cid
~~~
{zy:data action="nav" cid="0" order="sort asc" num="10" data="vo" loop="1"}
{$k} // 数组主键ID
{$vo.url} // 自动获取链接地址
{$vo.title} // 获取导航标题
{$vo.english} // 英文名称
{$vo.navurl} // 自定义链接
{$vo.wicket|target} // 新窗口打开
{if $vo.child == 1} // 判断是否存在子级
// 等于1,存在子级,循环输出子栏目
{zy:data action="nav" cid="$vo['id']" order="sort asc" num="10" data="v" loop="1"}
{$v.url} // 自动获取子级链接地址
{$v.title} // 获取导航标题
{/zy:data}
{else/}
// 不存在子级
{/if}
{/zy:data}
~~~
> 列表页调用默认选中导航
```
// 列表页 函数获取导航点击选中高亮
{:action($cid,$vo['id'],'class名')}
// 列表页 函数获取导航点击选中高亮,不选的话默认指定选择高亮
{:action($cid,$vo['id'],'class名',$k,0)} // 0 表示默认导航第一个选择
// 列表页 原生判断当前导航高亮
{if $cid == $vo.id}class="active"{/if}
```
> 获取当前导航列表ID查询当前ID单条数据,$cid 变量获取导航当前ID
```
// 获取表单独数据
{zy:info sql="navigation" where="status=1" limit="8" return="v" id="$cid"}
{$v.title}
{:buildNavUrl($v.type,$v.id,$v.navurl)} // 获取列表链接
{/zy:info}
// 获取全部表数据
{zy:info sql="navigation" where="status=1" limit="8" return="v"}
{$v.title}
{:buildNavUrl($v.type,$v.id,$v.navurl)} // 获取列表链接
{/zy:info}
```
> 配合后台导航列表的启动底部显示,在模板底部调用代码:
where="foot=1"
```
{zy:data action="nav" where="foot=1" order="sort asc" num="10" data="vo" loop="1"}
<a href="{$vo.url}">{$vo.title}</a>
{/zy:data}
```
| 返回字段值 | 说明 |
| --- | --- |
| id | 栏目id |
| mid | 模型ID |
| pid | 0为顶级导航,不是0表示上级父ID |
| url | 列表url路径 |
| catalog | 导航目录 |
| title | 导航名称 |
| subname| 导航SEO标题 |
| description | 导航SEO描述 |
| keyword | 导航SEO关键词 |
| child | 是否含有子级导航 0-不存在 1-存在 |
| english | 导航英文名 |
| navurl| 自定义链接,添加自定义链接才可填写 |
| wicket| 是否新窗口打开 1 是 0 否 |
| type | 导航类型 1-单页 2-列表 3-自定链接 |
| foot| 是否底部显示 1 是 0 否 |
| sort| 排序 |
| status | 状态 0-隐藏 1-显示 |