>[info]RGCMS的列表調用使用頻繁,系統提供了一套比較簡潔快速的調用方法
## **列表調用**
標簽:`{rg:list 參數名稱="參數值"}{/rg:list}`
**參數列表**
|參數(?為可選參數)|默認值|使用示例|解釋|
|---|---|---|---|
|?navid|默認當前欄目ID|navid="5" 或 navid="$nav_id" 或navid="$nav['id']"|要調用的欄目ID|
|?ispage|默認不分頁|ispage="simple"簡單分頁,ispage="true"正常分頁|是否分頁|
|?model||model="news"|根據模型標識調用內容|
|?onavid||onavid="1,2,3,4"|指定調用的欄目ID,<b>此時model參數必選</b><br><span style="color:orange">【1.12版本新增】使用:get_navids函數根據欄目分組獲取欄目id</span>|
|?enavid||enavid="5,6,7,8"|排除特定的欄目ID,<b>此時model參數必選</b><br><span style="color:orange">【1.12版本新增】使用:get_navids函數根據欄目分組獲取欄目id</span>|
|?empty|未查詢到相關記錄!|empty="無數據"|無結果時提示的文本|
|?where||where="id > 10"|根據條件進行篩選|
|?order|create_time desc|order="create_time asc"<br>order="rand"隨機排序|排序規則|
|?status|1(默認調用開啟的內容)|status="0"|調用開啟或關閉的內容|
|?key|i|key="y"|循環體內的計數變量,如{$i}從1開始計數|
|?limit|不限|limit="10"|調用數量|
|?site|當前站點ID|site="1"|站點ID|
>[warning]帶`?`為可選
**當使用model參數時,navid參數失效**
**當參數navid為循環體內ID時,比如欄目循環,寫為 navid="$nav['id']"數組形式**
>[danger] 分頁為自動識別,及手機訪問則為簡單分頁,PC訪問為正常分頁
調用該信息的欄目信息為 {$list.navlist.*} *為欄目信息字段
>[success]童鞋們舉栗子了:
```
調用當前當前欄目的列表內容,分頁顯示
<ul>
{rg:list limit="5" order="create_time desc" ispage="true"}
<li>
<a href="{$list.url}"><img src="{$list.img}"/><br>{$list.title}</a>
</li>
{/rg:list}
</ul>
分頁:{$page|raw}
說明:
{$list.url} 為該信息的內容頁URL地址,url字段請勿自定義
```
<span style="color:orange">【1.12版本新增】</span>使用get_navids函數根據欄目分組獲取欄目id,調用欄目分組顯示內容,分頁顯示
```
<ul>
{rg:list model="product" onavid=":get_navids('G1')" limit="5" order="create_time desc" ispage="true"}
<li>
<a href="{$list.url}"><img src="{$list.img}"/><br>{$list.title}</a>
</li>
{/rg:list}
</ul>
分頁:{$page|raw}
說明:
{$list.url} 為該信息的內容頁URL地址,url字段請勿自定義
```
```
調用其他欄目內容,不分頁
<ul>
{rg:list navid="1" limit="5" order="create_time desc"}
<li>
<a href="{$list.url}"><img src="{$list.img}"/><br>{$list.title}</a>
</li>
{/rg:list}
</ul>
說明:
{$list.url} 為該信息的內容頁URL地址,url字段請勿自定義
```