#### lists 标签参数（全局）[模块 cms]
| 参数名 | 注释 |
| --- | --- |
| catid | 栏目ID（栏目ID与模型ID必选其一）,<br>多个catid用,号分隔或使用where属性自定义查询条件<br>[默认空,modelid生效,$catid则表示当前页栏目ID] |
| modelid | 模型ID（栏目ID与模型ID必选其一）<br>[默认0，存在catid时,modelid自定指定对应模型ID,modelid="0"时，强制调用modelid=1的数据]<br> [新增参数] |
| where | where条件自定义查询条件（字符串，如：where="title like '%$广州%'"）[默认空]|
| flag | 文章属性标记 (0.1.2.3......)[默认空]|
| limit | 数据获取数量偏移值(如：limit="0,10"),如limit偏移量为0时，可直接使用参数num="10"代替此写法 |
| order | 排序,支持字符串或数组(如 order="listorder ASC,id DESC" ),[默认值空，默认空时使用id desc排序] |
| field | 仅返回指定字段值 [默认值 * ] |
| simple | 是否简单分页模式可选值: false 0 1, [默认值 false] |
| is_not_allow_hidden_category | 不允许调用隐藏栏目，<br>仅catid="0"或为空时有效<br> [新增参数] |
| page | 指定取第几页数据，$page则表示当前页码 |
| cache | 缓存时间（秒）（0或不设置此参数则不缓存） |
| moreinfo | int类型，是否获取更多关联数据项，[默认 0] <br>0 仅主表 <br>1 普通主附表联表查询 <br>2 项目关联查询仅返回主表数据 <br>3 项目关联查询返回主附表数据<br>[项目数据请参考联动项目管理数据]<br>[修改参数]|
**前端调用lists列表标签**
> 栏目列表页 当前栏目调用数据(标题、描述、栏目名称、日期)示例：
```
{yzn module="cms" action="lists" catid="$catid" cache="3600" order="updatetime desc" num="15" page="$page" return="data"}
{volist name="data" id="vo"}
{$vo.title}
{$vo.description}
{:getCategory($vo['catid'],'catname')}
{$vo.updatetime|date="m-d"}
{/volist}
{/yzn}
```
> 全局 指定调用栏目 catid=1 近期更新数据示例
```
{yzn module="cms" action="list" catid="1" modelid="1" limit="0,10" order="updatetime desc" cache="0"}
{volist name="data" id="vo" key="k"}
<li><a href="{$vo.url">{$vo.title}</a></li>
{/volist}
{/yzn}
```
> 全局 指定多个栏目数据调用热门数据示例
```
{yzn module="cms" action="lists" modelid="1" where="catid in(2,3)" cache="3600" order="hits DESC" num="10" return="data"}
{volist name="data" id="vo" key="k"}
<li><a href="{$vo.url">{$vo.title}</a></li>
{/volist}
{/yzn}
```
> 栏目列表页调用分页代码示例
```
<div class="pagelist">
<ul id="pagelist">
{$pages|raw}
</ul>
</div>
```
> 自动筛选模型对应的数据示例
```
<!--S 生成筛选列表 生成分类信息中的筛选菜单 -->
{volist name=":filters($modelid,$catid)" id="vo"}
{volist name="$vo.options" id="vs"}
<a target="_self" href="{$vs.url}" {if $vs.active}class="selected"{/if}>{$vs.title}</span></a>
{/volist}
{/volist}
<!--S 筛选条件 -->
{php}$where=structure_filters_sql($modelid);{/php}
<!--S 文章列表-->
{yzn module="cms" action="lists" where="$where" catid="$catid" cache="3600" order="updatetime DESC" num="8" page="$page" return="data"}
{volist name="data" id="vo" mod="4"}
<li {eq name="mod" value="3"}style="margin-right:0;" {/eq}>
{$vo.title|str_cut=###,12}
{$vo.description|str_cut=###,50}
</li>
{/volist}
{/yzn}
<!--S 分页-->
{$pages|raw}
```
> 栏目列表ajax加载数据示例
```
{php}
$catid=request()->param('catid/d',0);
if (empty($catid)) {
$cat = request()->param('catdir/s', '');
$catid = getCategory($cat,'id');
}
$page=request()->param('page/d',1);
$offset=($page-1)*5;
$limit="$offset,5";
{/php}
{yzn module="cms" action="lists" catid="$catid" order="listorder DESC" limit="$limit" return="data"}
{volist name="data" id="vo"}
{$vo.updatetime|date="m-d"}{$vo.updatetime|date="Y"}
{$vo.title}
{$vo.description|str_cut=###,60}
{/volist}
{/yzn}
{if !$__LIST__}
<div class="loadmore loadmore-line loadmore-nodata"><span class="loadmore-tips">暂无更多数据</span></div>
{else /}
<a href="?page={:$page+1}" data-page="{$page}" class="btn btn-loadmore">加载更多</a>
{/if}
<script type="text/javascript">
$(function() {
$(document).on("click", ".btn-loadmore", function() {
var that = this;
var page = parseInt($(this).data("page"));
page++;
$(that).prop("disabled", true);
$.ajax({
url: $(that).attr("href"),
type: "post",
success: function(res) {
$('.list').append(res.data);
$(that).remove();
return false;
},
});
return false;
})
});
</script>
```
