>[info] 內容列表的調用
## **內容列表**
標簽:`{rg:list 參數名稱="參數值"}{/rg:list}`
>[danger] 適用頁面:任何
>[danger] 標簽屬性:循環
>[danger] list標簽只調用內容模型的內容,其他模型內容無法調用
**常用參數列表**
|參數(?為可選參數)|默認值|使用示例|解釋|
|---|---|---|---|
|?model||model="product"|根據模型選數據|
|?nid||nid="2"或nid="$nav_id"|根據一個欄目ID列內容列表|
|?nids||nids="1,2,3,4"|根據多個欄目ID列內容列表|
|?enid||enid="1,2,3,4"|排除的欄目ID后的內容列表|
|?nalias||nalias="news"|根據欄目別名調用<span style="color:#ff0000">2020123101新增</span>|
|?naliases||naliases="product1,product2,product3"|根據多個欄目別名調用<span style="color:#ff0000">2020123101新增</span>|
|?ealias||ealias="product1"|要排除的欄目別名<span style="color:#ff0000">2020123101新增</span>|
|?limit|10|limit="4"|每頁數量|
|?total|false|total="1000"|輸出總量|
|?order|create_time desc|order="id desc",當order="rand"為隨機|排序,默認時間從近到遠|
|?ispage|false|ispage="true"|開啟分頁,一個頁面只允許一個分頁|
|?diypage|false|diypage="true"|是否啟用自定義分頁,需ispage=true,用法直達[自定義分頁](%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%86%E9%A1%B5.md)|
|?timing|false|timing="true"|開啟定時內容,默認關閉|
|?where||where="istop=1",符合sql語句|附加條件|
**不常用參數列表**
|參數(?為可選參數)|默認值|使用示例|解釋|
|---|---|---|---|
|?siteid|當前站點|siteid="1"|站點ID|
|?name|list|name="list2"|變量名稱|
|?key|i|key="i"|循環內計數變量|
|?empty|未查詢到相關記錄!|empty="無記錄"|無結果提示|
|?offset||offset="2"|從第幾個開始輸出|
**常用字段調用對照表**
~~~
自定義的字段
["*"] => * 代表自定義的字段名
固定字段
["id"] => 內容ID
["title"] => 內容標題
["navlist_id"] => 所屬欄目ID
["link"] => 內容外鏈
["author"] => 作者
["source"] => 來源
["img"] => 單圖
["imgs"] => 多圖
["keys"] => 內容關鍵詞
["desc"] => 內容描述
["hits"] => 內容點擊量
["content"] => 詳細內容
["istop"] => 是否置頂,1|0
["target"] => 內容頁打開方式
["site_id"] => 內容所屬站點ID
["torder"] => 內容排序
["create_time"] => 添加時間
["update_time"] => 編輯時間
["delete_time"] => 刪除時間
["url"] => 當前內容的url
當前內容的欄目信息
["navlist"]["id"] => 欄目ID
["navlist"]["name"] => 欄目名稱
["navlist"]["ename"] => 欄目副名稱
["navlist"]["pid"] => 欄目上級ID
["navlist"]["img"] => 欄目單圖
["navlist"]["keys"] => 欄目關鍵詞
["navlist"]["desc"] => 欄目描述
["navlist"]["target"] => 欄目的打開方式
["navlist"]["hasChild"] => 擁有子欄目的個數
["navlist"]["url"] => 欄目url
當前內容的模型信息
["navlist"]["cmsmodels"]["id"] => 模型ID
["navlist"]["cmsmodels"]["title"] => 模型名稱,如產品
["navlist"]["cmsmodels"]["name"] => 模型標識,如product
["navlist"]["cmsmodels"]["tablename"] => 模型表名
["navlist"]["cmsmodels"]["classname"] => 模型類名
["navlist"]["cmsmodels"]["attamodel_id"] => 模型附屬表ID
~~~
>[success]使用舉例
**一個常規的內容列表調用**
```
// 調用6條product模型中的內容
{rg:list model="product" limit="6"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
```
**輸出當前欄目頁的列表,當欄目為內容模型時**
```
// 欄目列表頁中當前欄目變量為$nav_id
{rg:list nid="$nav_id" limit="6" ispage="true"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
// 分頁,注意一個頁面中只能有一個分頁,只能有一個ispage="true"
{$page|raw}
```
或者
```
// 當前欄目頁內容列表,nid可省略
{rg:list limit="6" ispage="true"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
// 分頁,注意一個頁面中只能有一個分頁,只能有一個ispage="true"
{$page|raw}
```
**根據多個欄目ID調用內容列表,如產品**
```
// 調用product模型中欄目屬于3,5,6,8,9的內容,輸出6條
{rg:list nids="3,5,6,8,9" model="product" limit="6"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
```
**綜合調用(內置分頁),如產品**
```
// 輸出當前欄目頁內容,分頁,6條一頁,排除4,5欄目id,定時內容開啟,篩選出istop為1的內容,調用變量為prolist
{rg:list nid="$nav_id" limit="6" ispage="true" enid="4,5" timing="true" where="istop = 1" name="prolist"}
<li>
<img src="{$prolist['img']}">
<a href="{$prolist['url']}" title="{$prolist['title']}">{$prolist['title']}</a>
所屬欄目:<a href="{$prolist['navlist']['url']}">{$prolist['navlist']['name']}</a>
</li>
{/rg:list}
// 分頁,注意一個頁面中只能有一個分頁,只能有一個ispage="true"
{$page|raw}
```
**綜合調用(自定義分頁),如產品**
```
// 輸出當前欄目頁內容,自定義分頁,6條一頁,排除4,5欄目id,定時內容開啟,篩選出istop為1的內容,調用變量為prolist
{rg:list nid="$nav_id" limit="6" ispage="true" diypage="true" enid="4,5" timing="true" where="istop = 1" name="prolist"}
<li>
<img src="{$prolist['img']}">
<a href="{$prolist['url']}" title="{$prolist['title']}">{$prolist['title']}</a>
所屬欄目:<a href="{$prolist['navlist']['url']}">{$prolist['navlist']['name']}</a>
</li>
{/rg:list}
// 分頁,只有list開啟ispage=true 自定義分頁才有效
<div class="pages">
<ul>
<li><a href="{$page['homeUrl']}">首頁</a></li>
<li><a href="{$page['prevUrl']}">上一頁</a></li>
{rg:diypage limit="2"}
<li {if $diypage['iscurrent']}class="thisclass"{/if}><a href="{$diypage['url']}">第{$diypage['page']}頁</a></li>
{/rg:diypage}
<li><a href="{$page['nextUrl']}">下一頁</a></li>
<li><a href="{$page['lastUrl']}">尾頁</a></li>
</ul>
</div>
```
<span style="color:#ff0000">2020123101新增</span>
**根據欄目別名調用內容列表,如產品**
```
{rg:list naliases="product1,product2,product3" limit="6"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
```
```
{rg:list nalias="news" limit="6"}
<li>
<img src="{$list['img']}">
<a href="{$list['url']}" title="{$list['title']}">{$list['title']}</a>
所屬欄目:<a href="{$list['navlist']['url']}">{$list['navlist']['name']}</a>
</li>
{/rg:list}
```
- 系統概述
- 開始安裝
- 管理后臺(必懂部分)
- 配置設置
- 模型管理
- 字段管理
- 系統升級
- 關鍵詞庫
- TKD模板
- 鏈接&Robots
- 站點列表
- 站點信息&全局變量
- 欄目管理
- 單頁管理
- 欄目內容
- 功能管理
- 表單管理
- 后臺總結(必看)
- 標簽變量
- 頁面變量
- 全局變量
- 當前欄目
- 單頁內容
- 列表頁
- 詳情頁
- 標簽調用
- 站點列表
- 欄目調用(讀數據庫)
- 欄目調用(讀緩存)
- 內容列表
- 指定模型內容
- 自定義分頁
- 面包屑
- 功能調用
- 附屬表內容
- 單頁內容列表
- 多圖字段
- 表單內容列表
- 字符串分割
- 搜索頁列表
- 地區調用
- 關鍵詞列表
- 屬性列表
- 內容統計
- 比較判斷
- 常用比較
- 常用判斷
- 模板開發
- 模板目錄結構
- 路徑標簽
- 模板包含
- 模板命名
- 語言包
- 搜索表單
- 自定義表單
- 系統函數
- 默認值
- 無圖默認值
- 生成縮略圖
- 獲取多圖的某張
- 時間格式化
- 欄目字段繼承
- 字符截取
- 字符隱藏
- 分割獲取
- 二維碼
- 轉純文本
- 運算
- 避免混淆
- 其他常用
- 更新日志
- 問題排解