内容列表 · RGCMS V2使用手册

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