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

章節導航 [TOC] ## 內容列表標簽查詢模型數據列表、結合分頁標簽可實現分頁、例如獲取文章列表等可用該標簽。 ## 格式示例 ~~~ // 獲取模型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 | - | - | - | - | 模型ID | | aid | - | - | - | v2.2.3.220920+ | 指定單個文檔ID | | aids | 文檔ID:1,2,3 | - | - | v2.2.3.220920+ | 指定多個文檔ID,英文逗號分隔 | |field| - | * | - | v2.2.3.221215+ | 指定顯示的字段，默認是*表示所有，注意：系統已包含(id,lang,style,views,url,category_id,status)無需重復指定| | order | | weigh asc,id desc | - | - | 排序 , 格式為 order="字段名稱 desc" 其中desc是倒序，asc是升序| | num | 格式為數字、變量、5,10 |10 | - | - | 限制結果數量； 5,10：第五條開始，獲取10條數據 | | where | - | - | - | - | 數據庫查詢條件 | | page | 1 | - | - - | | 開啟分頁，配合 **{hkcms:contentpage /}** 分頁標簽 | | insub | 1-包含下級,0-不包含下級 | 1 | - | - | 需要與catid同時使用，默認包含下級文章 | | inlist | 1-列表模式,0-單頁內容 | 0 | - | - | 針對單頁，填寫catid時，獲取catid下級的所有單頁，支持分頁 | | more | 1 | - | - | v2.2.3.220920+不在使用 | 獲取副表的數據 | | flag | - | - | - | - | 文檔屬性值| | id | - | $item | - | - | 指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title} | | empty | - | - | - | - | 為空的時候輸出提示，支持傳入html | | cache | - | 3600秒 | - | - | 緩存時間，默認3600秒，對非分頁數據有效 | | mod | - | - | - | v2.2.1.20220603+ | 控制隔N行輸出的內容等，更多查看下面的示例 | | key | - | - | - | v2.2.1.20220603+ | 指定循環變量，如果沒有指定key屬性的話，默認使用循環變量$i | | filter | 1/0 | 1 | - | v2.3.1.231108+ | 默認是開啟篩選的（1開啟，0關閉），關閉后不受filter篩選標簽影響 | ## 參數說明 `catid` 欄目ID或變量，在列表頁時可不填，自動獲取列表頁的內容數據 1. 獲取屬于欄目ID為**7**，數量為**6**條的文檔 ~~~ {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條文檔并開啟分頁 ~~~ // 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條分頁展示 ~~~ {hkcms:content num="6" page="1"} <h5><a href="{$item.url}">{$item.title}</a></h5> {/hkcms:content} ~~~ 4. 同時獲取多個欄目ID的文檔數據，catid="欄目ID1,欄目id2" 多個欄目ID使用英文逗號分隔開 ~~~ {hkcms:content catid="11,12" num="6"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ~~~ `aid` 獲取單條文章，如下獲取文檔ID為14的記錄 ~~~ {hkcms:content aid="14"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ~~~ `aids` 獲取多條文章，多個文檔使用英文逗號分隔開 ~~~ {hkcms:content aids="14,15"} <a href="{$item.url}" style="{$item.style}">標題：{$item.title}</a> {/hkcms:content} ~~~ `model`模型ID參數表示按模型id來獲取記錄，模型ID在模型管理里面可以看到 ~~~ // 獲取模型id為1的記錄，num控制顯示數量 {hkcms:content model="1" num="5"} 文檔標題：{$item.title} 文檔描述：{$item.description} {/hkcms:content} ~~~ `order` 用于字段排序，格式為order="字段名 asc,字段名2 desc"，其中`asc` 表示升序 `desc` 表示倒序，多個排序字段使用逗號分隔開 ~~~ // 列表頁，按最新發布的靠前排序 {hkcms:content order="publish_time desc"} 文檔標題：{$item.title} 文檔描述：{$item.description} {/hkcms:content} ~~~ `num` 用于控制記錄條數，`num="5"` 表示只獲取5條記錄。也可以控制從第幾條開始，5,10表示第5～15條記錄。**注意5,10格式不能用于分頁上** ~~~ 注意這種限制范圍方式不得用于分頁 {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是當前欄目的分頁大小 ``` {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" ，支持傳入變量 ~~~ {// 獲取模型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** **更多查詢表達式參考：http://www.hmoore.net/manual/thinkphp6_0/1037537** `page` 開啟分頁功能，默認是沒有分頁的，開啟后配合`contentpage分頁標簽`來實現生成底部下的頁碼 ~~~ {// page="1" 開啟分頁} {hkcms:content model="1" page="1"} 標題：{$item.title} {/hkcms:content} ~~~ `insub` 控制是否顯示下級，該屬性需要結合`catid`來使用，默認自動包含該欄目下的所有文檔數據包含子級，值為1-包含下級，0-不包含下級。 ~~~ // 不包括子級下的文檔，注意獲取的下級是跟當前欄目模型一致 {hkcms:content catid="1" insub="0"} 標題：{$item.title} {/hkcms:content} ~~~ <blockquote class="danger">注意：獲取下級欄目的文檔是跟caitid里面的欄目ID模型一致</blockquote> `inlist` 列表模式用于獲取多條單頁模型的文章。例如catid="1"欄目ID為1是單頁欄目，那么默認情況下獲取的是一條單頁內容，獲取該單頁下所有單頁欄目里的文檔則可以使用該參數。示例如下： ~~~ 開啟列表模式，獲取當前欄目下5條單頁列表 {hkcms:content catid="1" inlist="1" num="5"} <div> {hkcms:raw name="$item['content']" /} </div> {/hkcms:content} ~~~ `more` ~~用于開啟列表頁獲取副表字段。模型管理里面字段管理可以看到字段是否是主表還是副表~~，**后續版本默認有副表字段無需手動開啟** ~~~ 開啟副表訪問 {hkcms:content model="1" more="1" num="5"} 副表內容：{$item.content} {/hkcms:content} ~~~ `flag` 用于輸出特定的文檔屬性，例如在文檔屬性里面新增了hot屬性，那么寫法如下 ~~~ 輸出模型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)`的屬性文檔 ~~~ // and 是同時滿足，注意兩邊的空格 {hkcms:content catid="9" flag="new and hot"} 標題：{$item.title} {/hkcms:content} ~~~ 2. 獲取擁有`最新(new)`或者有`熱門推薦(hot)`的屬性文檔 ~~~ // or 只需要包含其中一個屬性即可，注意兩邊的空格，多個寫法：flag="new or top or top" 以此類推 {hkcms:content catid="9" flag="new or top"} 標題：{$item.title} {/hkcms:content} ~~~ ` id` 用于改變循環變量默認是`$item`，例如改成$vo則寫成id="vo"無需加$。常用于多個標簽嵌套時使用循環變量而不受影響 ~~~ {hkcms:content catid="9" id="vo"} 標題：{$vo.title} {/hkcms:content} ~~~ `empty`為空(沒有數據)提示標簽，不支持傳入HTML，但可以傳入變量形式使用html 1. 示例如下：欄目id為111，里面沒有文檔時頁面上顯示`文檔內容不存在` ~~~ {hkcms:content catid="111" empty="文檔內容不存在"} 標題：{$item.title} {/hkcms:content} ~~~ 2. 傳入變量的形式插入html標簽 ~~~ {php}$empty = '- 沒有更多數據了 -';{/php} {hkcms:content catid="111" empty="$empty"} 標題：{$item.title} {/hkcms:content} ~~~ `cache` 設置緩存時間，默認是3600秒 ~~~ // 設置7200秒 {hkcms:content catid="9" cache="7200"} 標題：{$item.title} {/hkcms:content} ~~~ `mod`屬性用于每隔N行輸出的內容，例如控制N條記錄的換行、或增加hr等，例如下面的例子每輸出5個欄目增加一個下劃線標簽 ~~~ {hkcms:content catid="9" mod="5"} 標題：{$item.title} {if $mod==5} // 啟用mod后，會有$mod變量 <hr> {/if} {/hkcms:content} ~~~ 1. 輸出奇數偶數記錄，例如：mod="2"，標簽內會有$mod變量，里面的值每次計算到2的時候重新計數例如（1，2 | 1，2 | 1，2） ~~~ {hkcms:content catid="9" mod="2"} {if $mod==2} 偶數：{$item.title} {else /} 奇數：{$item.title} {/if} {/hkcms:content} ~~~ `key `參數用于指定循環`$i`的變量，只有標簽嵌套時可能需要重新命名$key ~~~ {hkcms:content catid="9"} // $i 是從1開始的。 序號：第{$i}篇文檔 標題：{$item.title} {/hkcms:content} ~~~ 改變$i的名稱 ~~~ {hkcms:content catid="9" key="ii"} 序號：第{$ii}篇文檔 標題：{$item.title} {/hkcms:content} ~~~ ## 常用示例 - 獲取欄目ID為1的列表 ~~~ {hkcms:content catid="1"} 計數變量：$i，從1開始：第{$i}篇 數組索引：{$key} 標題：{$item.title} 封面：{$item.thumb} URL：{$item.url} {/hkcms:content} // 傳入變量的形式 {hkcms:content catid="$Cate.id"} 標題：{$item.title} 封面：{$item.thumb} URL：{$item.url} {/hkcms:content} ~~~ - 根據模型ID獲取 ~~~ {hkcms:content model="1"} 循環變量，從1開始：{$i} 數組索引值：{$key} 標題：{$item.title} 封面：{$item.thumb} URL：{$item.url} 作者：{$item.author} 關鍵字：{$item.keywords} {/hkcms:content} ~~~ - 只獲取6條數據 ~~~ {hkcms:content model="1" num="6"} 循環變量，從1開始：{$i} 數組索引值：{$key} 標題：{$item.title} 封面：{$item.thumb} URL：{$item.url} 作者：{$item.author} 關鍵字：{$item.keywords} {/hkcms:content} ~~~ 獲取文章的分類信息與模型信息 ~~~ {hkcms:content model="1"} 標題：{$item.title} 封面：{$item.thumb} URL：{$item.url} <div>欄目名稱：{$item.category.title}</div> <div>欄目英文：{$item.category.name}</div> <div>模型名稱：{$item.model.name}</div> <div>模型類型：{$item.model.type}</div> {/hkcms:content} ~~~ - ~~獲取副表信息~~、后續版本默認包含 ~~~ {hkcms:content catid="1" more="1"} 標題：{$item.title} 封面：{$item.thumb} 瀏覽量：{$item.views} {/hkcms:content} ~~~ - 獲取包含欄目子級的列表數據 ~~~ 注：默認是包含的，如果不想包含 insub="0" 即可 {hkcms:content catid="1" insub="1"} 標題：{$item.title} {/hkcms:content} ~~~ - 數據分頁開啟分頁，每頁只顯示2條記錄 ~~~ {hkcms:content catid="1" page="1" num="2"} 標題：{$item.title} {/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兩邊的空格 ~~~ {hkcms:content num="6" page="1" flag="top or ceshi"} 標題：{$item.title} 循環文檔屬性(包含所有屬性字段)： {hkcms:volist name="item.flags" id="vo"} {$vo['title']} {/hkcms:volist} 原始值：{$item.flags_raw} {/hkcms:content} ~~~ ## 字段調用更多字段可在模型管理》字段管理里面找到字段的名字，以下僅包含主要的字段 **注意：其中`$item`變量根據content標簽的id參數影響，默認是：$item。$Info 是詳情頁固定調用方式** | 字段名 | 說明 | 調用方式 | 詳情頁 | | --- | --- | --- | --- | | id | 文檔ID | {$item.id} | {$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} |