>[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字段请勿自定义
```