>[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} ```