ThinkSSL🔒 一键申购 5分钟快速签发 30天无理由退款 购买更放心 广告
# 列表标签 描述:输出列表数据如:新闻列表,图片列表 | 额外参数 | 说明 |必须| | --- | --- | --- | | @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"}<br>值:{$key}<br>描述:{$v}<br>{/volist} |