描述:输出列表数据如:新闻列表,图片列表
| 额外参数 | 说明 | 必须 |
| --- | --- | --- |
| cid | 导航列表id,列表页,内容页可以使用 $cid 获取当前栏目id | 否 |
| order | 排序,例如order="id desc" | 否 |
| flag | 内容属性,例如: flag="1" 属说明: 置顶\[1\] 头条\[2\] 特荐\[3\] 推荐\[4\] 热点\[5\] 幻灯\[6\] | 否 |
| limit | 指定返回数据量 例如limit="5,10" ,不得和@num共存 | 否 |
| num | 每次返回数据量 例如num="5" | 否 |
| where | sql语句的where部分 例如:id = 1 AND status = 1 | 否 |
| page| 当前分页,默认$page,当传入该参数表示启用分页,一个页面只允许有一个page | 否 |
>## pages参数属性:输出分页{$pages|raw} num参数控制多少条分页
>## 此示例仅在列表页使用,在其他页面使用请去除 cid 参数或者把$cid改为固定值,移到最后看下面的
简单示例:
~~~
{zy:data action="list" cid="$cid" order="id desc" num="10" page="$page" loop="1" data="v"}
{$v.url} // 获取内页链接,也可以使用 {:buildContentUrl($v.cid,$v.id)}
{$v.title} // 获取标题
{notempty name="lists.tags"} // 获取tags标签
{volist name=":explode(',',$lists.tags)" id="vo"}
<a href="{:url('index/tags/index',['tag'=>$vo])}">{$vo}</a>
{/volist}
{/notempty}
{/zy:data}
<!--分页-->
{$pages|raw}
~~~
![](https://img.kancloud.cn/a5/5e/a55e541894ec77dfc023dff63eb37bb9_949x464.png)
> 如上图,拿新闻动态作为调用例子:
> cid=1 的意思是,获取 ID为 1 的子级新闻导航
```
{zy:data action="nav" cid="1" order="sort asc" num="10" data="vo" loop="1"}
{$vo.title} // 导航名称显示
{php}$id = $vo['id']; {/php} // 定义导航ID变量,通过ID来查询新闻表的cid
{zy:info sql="news" where="status=1 AND cid=$id" limit="8" return="v"}
{$v.title} // 获取新闻标题
{:buildContentUrl($v.cid,$v.id)} // 获取新闻内容链接
{$v.create_time|date="Y-m-d"} // 获取新闻时间
{/zy:info}
{/zy:data}
```