#### 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>
```
