列表标签

描述：输出列表数据如：新闻列表，图片列表

额外参数 说明 必须

@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.update_time|date="m-d"}</span><span class="year">{$vo.update_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描述

@create_time 文章发布时间 1.1.2 以下版本为inputtime

@update_time 文章更新时间 1.1.2 以下版本为updatetime

@content 文章内容（建副表才有）

@更多字段名称 这里指的是您该模型建的字段名称

根据模型字段类型不同 输出方式也不同如下：

类型 输出方式

单选按钮 / 下拉框 键：{$vo.字段名称} 值：{$vo.字段名称_text}

输入框 / 多行文本 / 数字 / 开关 / 日期和时间 / 颜色值 / 单图片 / {$vo.字段名称}

复选框 / 数组 / 多图片 {volist name="$vo['字段名称']" id="v"}

值：{$key}

描述：{$v}

{/volist}

希望以上内容对你有所帮助！如果还有其他问题，请随时提问。 各类知识收集 拥有多年CMS企业建站经验，对 lecms， classcms， fastadmin， pbootcms， phpcms， eyoucms， yzmcms， xunruicms， jizhicms， wordpress， hkcms， yzncms， 等各类cms的相互转化，程序开发，网站制作，bug修复，程序杀毒，插件定制都可以提供最佳解决方案。