content 內容列表標簽 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# content 內容列表標簽章節導航 - [內容列表標簽](#_5) - [格式示例](#_8) - [參數](#_16) - [參數說明](#_38) - [常用示例](#_259) - [字段調用](#_356) ## 內容列表標簽查詢模型數據列表、結合分頁標簽可實現分頁、例如獲取文章列表等可用該標簽。 ## 格式示例 ``` <pre class="calibre16">``` // 獲取模型ID為1的3條數據。 {hkcms:content model="1" num="3"} <a href="{$item.url}">標題：{$item.title}</a> {/hkcms:content} ``` ``` ## 參數參數名稱可選值默認值是否必填支持版本說明catid欄目ID或變量,多個欄目使用英文逗號分隔,必須是同模型v2.2.3.220920+-在列表頁可以不填,自動獲取。-默認包含下級文章的內容model----模型IDaid---v2.2.3.220920+指定單個文檔IDaids文檔ID:1,2,3--v2.2.3.220920+指定多個文檔ID,英文逗號分隔field-\*-v2.2.3.221215+指定顯示的字段，默認是\*表示所有，注意：系統已包含(id,lang,style,views,url,category\_id,status)無需重復指定orderweigh asc,id desc--排序 , 格式為 order="字段名稱 desc" 其中desc是倒序，asc是升序num格式為數字、變量、5,1010--限制結果數量； 5,10：第五條開始，獲取10條數據where----數據庫查詢條件page1-- -開啟分頁，配合 **{hkcms:contentpage /}** 分頁標簽insub1-包含下級,0-不包含下級1--需要與catid同時使用，默認包含下級文章inlist1-列表模式,0-單頁內容0--針對單頁，填寫catid時，獲取catid下級的所有單頁，支持分頁more1--v2.2.3.220920+不在使用獲取副表的數據flag----文檔屬性值id-$item--指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title}empty----為空的時候輸出提示，支持傳入htmlcache-3600秒--緩存時間，默認3600秒，對非分頁數據有效mod---v2.2.1.20220603+控制隔N行輸出的內容等，更多查看下面的示例key---v2.2.1.20220603+指定循環變量，如果沒有指定key屬性的話，默認使用循環變量$i## 參數說明 `catid` 欄目ID或變量，在列表頁時可不填，自動獲取列表頁的內容數據 1. 獲取屬于欄目ID為**7**，數量為**6**條的文檔 ``` <pre class="calibre16">``` {hkcms:content catid="7" num="6"} // style字段是后臺內容管理標題加粗、標題顏色，如果需要那么按以下寫法獲取 <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> 封面圖：<img src="{$item.thumb}"> // 更多字段可前往后臺字段管理里面或手冊數據字典里面查看 {/hkcms:content} ``` ``` 2. 以變量形式獲取，例如在列表頁有當前欄目變量($Cate)，`catid="$Cate.id"` $Cate.id是欄目ID，下面示例為獲取當前欄目6條文檔并開啟分頁 ``` <pre class="calibre16">``` // page="1" 是開啟分頁 {hkcms:content catid="$Cate.id" num="6" page="1"} <h5><a href="{$item.url}">標題：{$item.title}</a></h5> {/hkcms:content} ``` ``` 3. 在列表頁，獲取當前欄目的文檔，可以不傳`catid`參數，如下按每頁6條分頁展示 ``` <pre class="calibre16">``` {hkcms:content num="6" page="1"} <h5><a href="{$item.url}">{$item.title}</a></h5> {/hkcms:content} ``` ``` 4. 同時獲取多個欄目ID的文檔數據，catid="欄目ID1,欄目id2" 多個欄目ID使用英文逗號分隔開 ``` <pre class="calibre16">``` {hkcms:content catid="11,12" num="6"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ``` ``` `aid` 獲取單條文章，如下獲取文檔ID為14的記錄 ``` <pre class="calibre16">``` {hkcms:content aid="14"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ``` ``` `aids` 獲取多條文章，多個文檔使用英文逗號分隔開 ``` <pre class="calibre16">``` {hkcms:content aids="14,15"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ``` ``` `model`模型ID參數表示按模型id來獲取記錄，模型ID在模型管理里面可以看到 ``` <pre class="calibre16">``` // 獲取模型id為1的記錄，num控制顯示數量 {hkcms:content model="1" num="5"} 文檔標題：{$item.title} 文檔描述：{$item.description} {/hkcms:content} ``` ``` `order` 用于字段排序，格式為order="字段名 asc,字段名2 desc"，其中`asc` 表示升序 `desc` 表示倒序，多個排序字段使用逗號分隔開 ``` <pre class="calibre16">``` // 列表頁，按最新發布的靠前排序 {hkcms:content order="publish_time desc"} 文檔標題：{$item.title} 文檔描述：{$item.description} {/hkcms:content} ``` ``` `num` 用于控制記錄條數，`num="5"` 表示只獲取5條記錄。也可以控制從第幾條開始，5,10表示第5～15條記錄。**注意5,10格式不能用于分頁上** ``` <pre class="calibre16">``` 注意這種限制范圍方式不得用于分頁 {hkcms:content model="1" num="5,10"} 標題：{$item.title} {/hkcms:content} ``` ``` 1. 動態控制每頁展示文檔條數可以在后臺欄目管理里面配置（欄目管理-》添加-》更多-》分頁大小） ![](https://img.kancloud.cn/83/1d/831d044ca1a66ff001694420cf6c3177_631x89.png) 動態文檔條數寫法示例，num="$Cate.num"，$Cate.num是當前欄目的分頁大小 ``` <pre class="calibre16">``` {hkcms:content num="$Cate.num" page="1"} // style字段是后臺可設置加粗與顏色 <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ``` ``` `where` 數據庫查詢條件，語法跟SQL where基本相同。格式：where="字段名 = 1" ，支持傳入變量 ``` <pre class="calibre16">``` {// 獲取模型id為1的記錄，where條件意思是只顯示閱讀量大于1的記錄} {hkcms:content model="1" where="views > 1"} 標題：{$item.title} 描述：{$item.description} {/hkcms:content} ``` ``` **sql語法可參考：[https://www.w3school.com.cn/sql/sql\_where.asp](https://www.w3school.com.cn/sql/sql_where.asp)** **更多查詢表達式參考：[http://www.hmoore.net/manual/thinkphp6\_0/1037537](http://www.hmoore.net/manual/thinkphp6_0/1037537)** `page` 開啟分頁功能，默認是沒有分頁的，開啟后配合`contentpage分頁標簽`來實現生成底部下的頁碼 ``` <pre class="calibre16">``` {// page="1" 開啟分頁} {hkcms:content model="1" page="1"} 標題：{$item.title} {/hkcms:content} ``` ``` `insub` 控制是否顯示下級，該屬性需要結合`catid`來使用，默認自動包含該欄目下的所有文檔數據包含子級，值為1-包含下級，0-不包含下級。 ``` <pre class="calibre16">``` // 不包括子級下的文檔，注意獲取的下級是跟當前欄目模型一致 {hkcms:content catid="1" insub="0"} 標題：{$item.title} {/hkcms:content} ``` ``` > 注意：獲取下級欄目的文檔是跟caitid里面的欄目ID模型一致 `inlist` 列表模式用于獲取多條單頁模型的文章。例如catid="1"欄目ID為1是單頁欄目，那么默認情況下獲取的是一條單頁內容，獲取該單頁下所有單頁欄目里的文檔則可以使用該參數。示例如下： ``` <pre class="calibre16">``` 開啟列表模式，獲取當前欄目下5條單頁列表 {hkcms:content catid="1" inlist="1" num="5"} <div> {hkcms:raw name="$item['content']" /} </div> {/hkcms:content} ``` ``` `more`用于開啟列表頁獲取副表字段。模型管理里面字段管理可以看到字段是否是主表還是副表，**后續版本默認有副表字段無需手動開啟** ``` <pre class="calibre16">``` 開啟副表訪問 {hkcms:content model="1" more="1" num="5"} 副表內容：{$item.content} {/hkcms:content} ``` ``` `flag` 用于輸出特定的文檔屬性，例如在文檔屬性里面新增了hot屬性，那么寫法如下 ``` <pre class="calibre16">``` 輸出模型ID為1且文章帶有hot屬性的記錄 {hkcms:content flag="hot" model="1" num="5"} 標題：{$item.title} {/hkcms:content} ``` ``` flag屬性里面填寫的是下面圖片中的屬性值 ![](https://img.kancloud.cn/2c/2c/2c2c2437caffcdf015cbf0f1c9f9316e_747x264.png) 1. flag屬性多個使用：and 或 or 關鍵字，例如獲取同時擁有`最新(new)`和`熱門推薦(hot)`的屬性文檔 ``` <pre class="calibre16">``` // and 是同時滿足，注意兩邊的空格 {hkcms:content catid="9" flag="new and hot"} 標題：{$item.title}<br/> {/hkcms:content} ``` ``` 2. 獲取擁有`最新(new)`或者有`熱門推薦(hot)`的屬性文檔 ``` <pre class="calibre16">``` // or 只需要包含其中一個屬性即可，注意兩邊的空格，多個寫法：flag="new or top or top" 以此類推 {hkcms:content catid="9" flag="new or top"} 標題：{$item.title}<br/> {/hkcms:content} ``` ``` `id` 用于改變循環變量默認是`$item`，例如改成$vo則寫成id="vo"無需加$。常用于多個標簽嵌套時使用循環變量而不受影響 ``` <pre class="calibre16">``` {hkcms:content catid="9" id="vo"} 標題：{$vo.title}<br /> {/hkcms:content} ``` ``` `empty`為空(沒有數據)提示標簽，不支持傳入HTML，但可以傳入變量形式使用html 1. 示例如下：欄目id為111，里面沒有文檔時頁面上顯示`文檔內容不存在` ``` <pre class="calibre16">``` {hkcms:content catid="111" empty="文檔內容不存在"} 標題：{$item.title}<br /> {/hkcms:content} ``` ``` 2. 傳入變量的形式插入html標簽 ``` <pre class="calibre16">``` {php}$empty = '- 沒有更多數據了 -';{/php} {hkcms:content catid="111" empty="$empty"} 標題：{$item.title}<br /> {/hkcms:content} ``` ``` `cache` 設置緩存時間，默認是3600秒 ``` <pre class="calibre16">``` // 設置7200秒 {hkcms:content catid="9" cache="7200"} 標題：{$item.title}<br /> {/hkcms:content} ``` ``` `mod`屬性用于每隔N行輸出的內容，例如控制N條記錄的換行、或增加hr等，例如下面的例子每輸出5個欄目增加一個下劃線標簽 ``` <pre class="calibre16">``` {hkcms:content catid="9" mod="5"} 標題：{$item.title}<br/> {if $mod==5} // 啟用mod后，會有$mod變量 <hr> {/if} {/hkcms:content} ``` ``` 1. 輸出奇數偶數記錄，例如：mod="2"，標簽內會有$mod變量，里面的值每次計算到2的時候重新計數例如（1，2 | 1，2 | 1，2） ``` <pre class="calibre16">``` {hkcms:content catid="9" mod="2"} {if $mod==2} 偶數：{$item.title} <br> {else /} 奇數：{$item.title} <br> {/if} {/hkcms:content} ``` ``` `key`參數用于指定循環`$i`的變量，只有標簽嵌套時可能需要重新命名$key ``` <pre class="calibre16">``` {hkcms:content catid="9"} // $i 是從1開始的。 <p>序號：第{$i}篇文檔 </p> <p>標題：{$item.title} </p> {/hkcms:content} ``` ``` 改變$i的名稱 ``` <pre class="calibre16">``` {hkcms:content catid="9" key="ii"} <p>序號：第{$ii}篇文檔 </p> <p>標題：{$item.title} </p> {/hkcms:content} ``` ``` ## 常用示例 - 獲取欄目ID為1的列表 ``` <pre class="calibre16">``` {hkcms:content catid="1"} <p>計數變量：$i，從1開始：第{$i}篇</p> <p>數組索引：{$key}</p> <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>URL：{$item.url}</p> {/hkcms:content} // 傳入變量的形式 {hkcms:content catid="$Cate.id"} <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>URL：{$item.url}</p> {/hkcms:content} ``` ``` - 根據模型ID獲取 ``` <pre class="calibre16">``` {hkcms:content model="1"} <p>循環變量，從1開始：{$i}</p> <p>數組索引值：{$key}</p> <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>URL：{$item.url}</p> <p>作者：{$item.author}</p> <p>關鍵字：{$item.keywords}</p> {/hkcms:content} ``` ``` - 只獲取6條數據 ``` <pre class="calibre16">``` {hkcms:content model="1" num="6"} <p>循環變量，從1開始：{$i}</p> <p>數組索引值：{$key}</p> <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>URL：{$item.url}</p> <p>作者：{$item.author}</p> <p>關鍵字：{$item.keywords}</p> {/hkcms:content} ``` ``` 獲取文章的分類信息與模型信息 ``` <pre class="calibre16">``` {hkcms:content model="1"} <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>URL：{$item.url}</p> <div>欄目名稱：{$item.category.title}</div> <div>欄目英文：{$item.category.name}</div> <div>模型名稱：{$item.model.name}</div> <div>模型類型：{$item.model.type}</div> {/hkcms:content} ``` ``` - 獲取副表信息、后續版本默認包含 ``` <pre class="calibre16">``` {hkcms:content catid="1" more="1"} <p>標題：{$item.title}</p> <p>封面：{$item.thumb}</p> <p>瀏覽量：{$item.views}</p> {/hkcms:content} ``` ``` - 獲取包含欄目子級的列表數據 ``` <pre class="calibre16">``` 注：默認是包含的，如果不想包含 insub="0" 即可 {hkcms:content catid="1" insub="1"} <p>標題：{$item.title}</p> {/hkcms:content} ``` ``` - 數據分頁開啟分頁，每頁只顯示2條記錄 ``` <pre class="calibre16">``` {hkcms:content catid="1" page="1" num="2"} <p>標題：{$item.title}</p> {/hkcms:content} <div> //配合分頁標簽 {hkcms:contentpage item="home,pre,pageno,next,last,info,jump" /} </div> ``` ``` - 文檔屬性 flag="top and new"表示只查出同時滿足top和new屬性值，flags="top or new"表示只要查出有top或new屬性值，注意and和or兩邊的空格 ``` <pre class="calibre16">``` {hkcms:content num="6" page="1" flag="top or ceshi"} 標題：{$item.title} 循環文檔屬性(包含所有屬性字段)： {hkcms:volist name="item.flags" id="vo"} <span>{$vo['title']}</span> {/hkcms:volist} 原始值：{$item.flags_raw} {/hkcms:content} ``` ``` ## 字段調用更多字段可在模型管理》字段管理里面找到字段的名字，以下僅包含主要的字段 **注意：其中`$item`變量根據content標簽的id參數影響，默認是：$item。$Info 是詳情頁固定調用方式** 字段名說明調用方式詳情頁id文檔ID{$[item.id](http://item.id)}{$[Info.id](http://Info.id)}category\_id文檔所屬欄目ID{$item.category\_id}{$Info.category\_id}category\_ids文檔所屬父欄目ID，例如：1,2,3 逗號分隔開{$item.category\_ids}{$Info.category\_ids}model\_id文檔所屬模型ID{$item.model\_id}{$Info.model\_id}flags文檔屬性，數組，使用volist標簽循環{$item.flags}{$Info.flags}- title使用volist循環后，里面寫{$item.title}，文檔屬性標題--- name文檔屬性標題--flags\_raw文檔屬性，多個屬性逗號分隔，例如：top,new{$item.flags\_raw}{$Info.flags\_raw}lang語言標識{$item.lang}{$Info.lang}publish\_time發布時間，格式是秒，使用date日期格式化標簽，或使用下方的字段{$item.publish\_time}{$Info.publish\_time}publish\_time\_text發布時間，格式是年月日時分秒{$item.publish\_time\_text}{$Info.publish\_time\_text}fullurl包含完整域名的URL{$item.fullurl}{$Info.fullurl}