# 列表标签 描述：输出列表数据如：新闻列表，图片列表 | 额外参数 | 说明 |必须| | --- | --- | --- | | @catid | 栏目列表id，列表页，内容页可以使用 $catid 获取当前栏目id，【modelid】参数有值时，可省略此参数 | 否 | | @modelid | 模型id，列表页，内容页可以使用 $modelid 获取当前模型id，【catid】参数有值时，可省略此参数 |否 | | @order| 排序，例如：order="id DESC" ，随机可以使用order="[rand]"|否 | | @field| 取出指定字段(副表无效，副表全部取出)，例如：field="title,catid,id" |否 | | @flag| 内容属性，例如: flag="4,5" 多个用逗号隔开  属说明: 置顶[1]  头条[2]  特荐[3] 推荐[4] 热点[5] 幻灯[6] |否| | @limit| 指定返回数据量 例如：limit="5,10" ，不得和@num共存,共存则优先使用limit |否 | | @num| 每次返回数据量 例如：num="5" |否 | | @where| sql语句的where部分 例如：thumb != '' AND status = 1| 否 | | @moreinfo| 是否调用副表数据 1为是 0为否 默认为否| 否 | | @page| 当前分页号，默认$page，当传入该参数表示启用分页，一个页面只允许有一个page，多个标签使用多个page会造成不可预知的问题。 | 否 | |@simple|例如：simple="true"代表简洁模式，只有上下页，为数字时代表总记录数|否| |@pagepath|具体使用方法请查看【技巧/问题】-【分页伪静态】|否| > 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} ``` > PS:如果指定多个栏目可以用where="catid in(5,6,7,8)" ，这些id必须属于一个模型 > @catid可以省略，但是@modelid参数必须指定 > 比如 {yzn module="cms" action="lists" where="catid in(5,6,7,8)" modelid="3" order="listorder ASC" num="10" return="data"} 完整示例： ``` //输出当前栏目id的列表10条文章 带分页并缓存3600秒 <!--S 列表循环开始--> {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.publish_time|date="m-d"}</span><span class="year">{$vo.publish_time|date="Y"}</span></div> <h3>{$vo.title}</h3> <div class="txt">{$vo.description|str_cut=###,60}</div> </a> </li> {/volist} {/yzn} <!--E 列表循环结束--> <!--S 分页开始--> {$pages|raw} <!--E 分页结束--> 输出总页数{$data->total()}，只有标签使用分页才能使用 ``` | 返回变量 | 说明 | | --- | --- | | @id | 栏目id | | @catid | 栏目列表id | | @url | 文章url路径 | | @title | 文章标题 | | @thumb | 缩略图 | | @hits | 文章点击次数 | | @keywords | SEO关键词 | | @description | SEO描述 | | @publish_time | 文章发布时间 | | @create_time | 文章创建时间 | | @update_time | 文章更新时间| | @content | 文章内容（建副表才有） | | @更多字段名称|这里指的是您该模型建的字段名称 | **根据模型字段类型不同 输出方式也不同如下：** | 类型 |输出方式 | | --- | --- | | 单选按钮 / 下拉框 | 键：`{$vo.字段名称}` 值：{$vo.字段名称_text} | | 输入框 / 多行文本 / 数字 / 开关 / 日期和时间 / 颜色值 / 单图片 / | `{$vo.字段名称}` | | 复选框 / 数组 / 多图片 | {volist name="$vo['字段名称']" id="v"}<br>值：{$key}<br>描述：{$v}<br>{/volist} |