# 列表标签 描述：输出列表数据如：新闻列表，图片列表 | 额外参数 | 说明 |必须| | --- | --- | --- | | @catid | 栏目列表id，列表页，内容页可以使用 $catid 获取当前栏目id，【modelid】参数有值时，可省略此参数 | 否 | | @modelid | 模型id，列表页，内容页可以使用 $modelid 获取当前模型id，【catid】参数有值时，可省略此参数 |否 | | @order| 排序，例如order="id DESC" |否 | | @flag| 内容属性，例如: flag="1"  属说明: 置顶[1]  头条[2]  特荐[3] 推荐[4] 热点[5] 幻灯[6] |否| | @limit| 指定返回数据量 例如limit="5,10" 和@num参数不同，有此参数，不得带@page参数,且不得和@num共存 |否 | | @num| 每次返回数据量 例如num="5" |否 | | @where| sql语句的where部分 例如：thumb != '' AND status = 1| 否 | | @moreinfo| 是否调用副表数据 1为是 0为否 默认为否| 否 | | @page| 当前分页号，默认$page，当传入该参数表示启用分页，一个页面只允许有一个page，多个标签使用多个page会造成不可预知的问题。 | 否 | > moreinfo参数属性：本参数表示在返回数据的时候，会把副表中的数据也一起返回。一个内容模型分为2个表，一个主表一个副表，主表中一般是保存了标题、所属栏目等等短小的数据（方便用于索引），而副表则保存了大字段的数据，如内容等数据。在模型管理中新建字段的时候，是允许你选择存入到主表还是副表的（我们推荐的是，把不重要的信息放到副表中）。想要在列表中调取副表的数据就需要在标签中使用moreinfo这个属性。 > pages参数属性：输出分页{$pages|raw} @num参数控制多少条分页 简单示例： ``` {yzn module="cms" action="lists" catid="$catid" cache="3600" order="listorder ASC" num="10" page="$page" return="data"} {volist name="data" id="vo"} ...HTML... {/volist} {/yzn} ``` 完整示例： ``` //输出当前栏目id的列表10条文章 带分页并缓存3600秒 {yzn module="cms" action="lists" catid="$catid" cache="3600" order="listorder ASC" num="10" page="$page" return="data"} {volist name="data" id="vo"} <li class="item clearfix"> <a href="{$vo.url}" title="{$vo.title}"><img class="fl" src="{$vo.thumb}" alt="{$vo.title}"> <div class="time fr"><span class="day">{$vo.updatetime|date="m-d"}</span><span class="year">{$vo.updatetime|date="Y"}</span></div> <h3>{$vo.title}</h3> <div class="txt">{$vo.description|str_cut=###,60}</div> </a> </li> {/volist} {/yzn} <!--分页--> {$pages|raw} ``` | 返回变量 | 说明 | | --- | --- | | @id | 栏目id | | @catid | 栏目列表id | | @url | 文章url路径 | | @title | 文章标题 | | @thumb | 缩略图 | | @hits | 文章点击次数 | | @keywords | SEO关键词 | | @description | SEO描述 | | @inputtime | 文章发布时间 | | @updatetime | 文章更新时间 | | @content | 文章内容（建副表才有） | | *其他 | *其他模型字段 |