channel 欄目標簽 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# channel 欄目標簽 - [欄目標簽](#_2) - [格式示例](#_4) - [參數](#_20) - [參數說明](#_39) - [示例](#_227) - [數據字典](#_284) ## 欄目標簽用于調用欄目管理的數據 ## 格式示例 ``` <pre class="calibre16">``` // 獲取頂級菜單欄目 {hkcms:channel type="top" where="ismenu=1"} 標題：{$item.title} {/hkcms:channel} ``` ``` > 2.1.220504\_202205201800版本起，新增ismenu屬性，如下 ``` <pre class="calibre16">``` // 獲取頂級菜單欄目、顯示導航欄目菜單 {hkcms:channel type="top" ismenu="1"} 標題：{$item.title} {/hkcms:channel} ``` ``` ## 參數參數名稱可選值默認值是否必填支持版本說明name欄目ID或變量-type值為peer或son時必填-欄目ID，可以傳入變量或指定ID，2.2.3.220920版本起支持多個id，詳情見下面參數說明typeson peer top---指定獲取的欄目層級 son-獲取下級欄目 peer-表示同級欄目 top-表示頂級欄目num例子： 10 或者 10,12---限制結果數量例如： 10 : 表示獲取10條 10,12 : 表從第10開始的12條記錄model模型表ID---指定模型IDwhere----數據庫查詢條件order-weigh desc--排序方式, 格式為 order="字段名稱 desc" 其中desc是倒序，asc是升序id-$item--指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title}empty----為空的時候輸出提示，支持傳入htmlcurrentstyle-active--css class 類名，用于定義當前選中狀態樣式cache-3600秒--緩存時間，默認3600秒istotal1---統計文檔數量ismenu1-->=v2.1.220504顯示導航欄目菜單lang--->=v2.2.1.20220603多語言情況下獲取指定語言的欄目mod--->=v2.2.1.20220603調用：{$mod} 用于控制偶數輸出、換行等，更多查看下面的示例key--->=v2.2.1.20220603指定循環值變量名，默認為$i，從1開始計數每循環一次+1## 參數說明 - `name` 參數通常用于查單條特定的欄目數據。如果type值為peer或son時該值必填，支持變量或數字id 獲取欄目ID為3的記錄``` <pre class="calibre20">``` {hkcms:channel name="3"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` 根據變量來獲取欄目，假設在內容詳情頁有`$Info`變量，$[Info.categroy.id](http://Info.categroy.id) 是當前文章所屬ID，那么我們可以通過這個id來獲取欄目同級的欄目代碼如下： ``` <pre class="calibre16">``` // 同級 {hkcms:channel name="$Info.category.id" type="peer"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` 或者使用變量可以獲取當前欄目的上級欄目信息 ``` <pre class="calibre16">``` // $Cate 是當前欄目的信息該變量在欄目首頁、列表頁、詳情頁、單頁都存在 {hkcms:channel name="$Cate.parent_id"} 欄目標題：{$item.title} {/hkcms:channel} ``` ``` 2.2.3.220920版本起支持多個id獲取欄目。如下，多個欄目ID逗號分隔開 ``` <pre class="calibre16">``` {hkcms:channel name="1,3,7"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `type`屬性用于獲取的欄目層級，如下 1.`son` 獲取下級欄目，需要結合name使用 ``` <pre class="calibre16">``` // 獲取欄目ID為1的所有下級菜單 {hkcms:channel name="1" type="son" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` 2.`peer` 表示同級欄目，需要結合name使用 ``` <pre class="calibre16">``` // 獲取欄目ID為1的所有同級菜單 {hkcms:channel name="1" type="peer" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` 3.`top` 表示頂級欄目 ``` <pre class="calibre16">``` // 獲取頂級菜單 {hkcms:channel type="top" ismenu="1" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `num` 限制結果數量。例如獲取10條欄目那么num="10"，當然也支持從第幾條開始，例如num="4,2" 表示從第4條獲取兩條那就是第4條、第五條。 ``` <pre class="calibre16">``` // 獲取頂級欄目從第二條開始獲取兩條 {hkcms:channel type="top" ismenu="1" num="2,3"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `model`模型id，模型ID在模型管理里面可以看到 ``` <pre class="calibre16">``` // 獲取模型id=1的所有欄目 {hkcms:channel model="1"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` ``` <pre class="calibre16">``` // 使用變量的形式獲取頂級欄目 {hkcms:channel model="$Info.model_id" type="top"} 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `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)** - `order` 用于字段排序例如上面的代碼，格式為order="字段名 asc,字段名2 desc"，其中`asc` 表示正序 `desc` 表示倒序，多個排序字段使用逗號分隔開 ``` <pre class="calibre16">``` // 多個字段排序使用逗號分隔開 {hkcms:channel name="21" type="son" order="weigh asc" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `id` 用于改變循環變量默認是$item，例如改成$vo則寫成id="vo"無需加$。常用于多個標簽嵌套時使用循環變量而不受影響 ``` <pre class="calibre16">``` {hkcms:channel name="21" type="son" id="vo" } 標題：{$vo.title} <br> {/hkcms:channel} ``` ``` - `empty`為空提示標簽，不支持傳入HTML，但可以傳入變量 ``` <pre class="calibre16">``` {hkcms:channel name="111" type="son" empty="沒有更多數據了" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` 傳入變量的形式使用html ``` <pre class="calibre16">``` {php}$empty = '- 沒有更多數據了 -';{/php} {hkcms:channel name="111" type="son" empty="$empty"} {php}dump($item){/php} {/hkcms:channel} ``` ``` - `currentstyle` 當前選中欄目的class樣式用于字體高亮等自定義樣式、值默認是active ``` <pre class="calibre16">``` // currentstyle 默認是active，你可以在這指定其他的class {hkcms:channel type="top" ismenu="1" currentstyle="active"} // 例如：如果當前是新聞中心欄目那么只有新聞中心欄目這條記錄有 active 類 <li class="nav-item dropdown {$item.currentstyle}"> <a class="nav-link dropdown-toggle" href="{$item.url}" target="{$item.target}">{$item.title} <i class="fa fa-angle-down"></i></a> </li> {/hkcms:channel} ``` ``` - `cache` 設置緩存時間單位是秒，系統默認緩存是3600秒，設置成一天：cache="86400" - `istotal` 開啟文檔數量統計，istotal="1"開啟 ``` <pre class="calibre16">``` {hkcms:channel name="9" type="son" istotal="1" } 標題：{$item.title} <br> 數量：{$item.total} <br> {/hkcms:channel} ``` ``` - `ismenu` 顯示導航菜單，值為ismenu="1"。在后臺欄目管理頁面可以控制導航菜單的顯示。 ``` <pre class="calibre16">``` // 獲取頂級菜單欄目 {hkcms:channel type="top" ismenu="1"} 標題：{$item.title} {/hkcms:channel} ``` ``` - `lang` 指定獲取特定語言的欄目，需要開啟內容多語言才有效 ``` <pre class="calibre16">``` // lang="en" 只獲取英文不管語言怎么切換都是英文 {hkcms:channel name="9" lang="en" } 標題：{$item.title} <br> {/hkcms:channel} ``` ``` - `mod`屬性用于控制一定記錄的換行、或增加hr或奇數偶數等標簽處理，例如下面的例子每輸出5個欄目增加個hr標簽 ``` <pre class="calibre16">``` {hkcms:channel type="top" mod="5"} <p>標題：{$item.title} <br></p> // $mod的值是從1開始的 {if $mod==5} <hr> {/if} {/hkcms:channel} ``` ``` mod輸出奇數偶數記錄，設mod="2"，標簽內會有$mod變量，里面的值每次計算到2的時候重新計數例如（1，2，1，2，1，2） ``` <pre class="calibre16">``` {hkcms:channel type="top" mod="2"} {if $mod==2} 偶數：{$item.title} <br> {else /} 奇數：{$item.title} <br> {/if} {/hkcms:channel} ``` ``` - `key`參數用于指定循環$i的變量，只有標簽嵌套時可能需要重新命名$key ``` <pre class="calibre16">``` {hkcms:channel type="top"} // $i 是從1開始的。 <p>序號{$i}： <br></p> <p>標題：{$item.title} <br></p> {/hkcms:channel} ``` ``` 更改循環變量示例 ``` <pre class="calibre16">``` {hkcms:channel type="top" key="ii"} // key="j" 表示這個標簽的循環值是{$j}，這樣就可以避免嵌套的標簽依然可以獲取外層的標簽$ii變量。 {hkcms:channel name="$item['id']" id="son" type="son" key="j" } <p>外層的循環值：{$ii} <br></p> <p>里面這個標簽的$值：{$j} <br></p> <p>標題：{$son.title} <br></p> {/hkcms:channel} {/hkcms:channel} ``` ``` ## 示例 - 多級嵌套獲取導航欄的欄目數據 ``` <pre class="calibre16">``` // type = top, 獲取的是頂級欄目。ismenu=1獲取導航，在欄目管理里面可以控制導航顯示 {hkcms:channel type="top" ismenu="1"} // $item 默認的循環變量名，{if}{/if}這是if語句，下面是判斷是不是有下級，有下級就顯示下拉列表。 <li class="{$item.currentstyle} nav-item {if $item.has_child}dropdown{/if}"> <a href="{$item.url}" target="{$item.target}" class="nav-link" title="{$item.title}">{$item.title}</a> {if $item.has_child} <ul class="dropdown-menu mt-0"> // 獲取下級欄目，id="son"表示里面的循環變量由默認的$item變成$son,在標簽嵌套中這樣使用不會影響上級的$item變量 {hkcms:channel name="$item['id']" id="son" type="son" ismenu="1"} <a href="{$son.url}" class="dropdown-item {$son.currentstyle} " title="{$son.title}">{$son.title}</a> {/hkcms:channel} </ul> {/if} </li> {/hkcms:channel} ``` ``` - 獲取同級欄目示例 ``` <pre class="calibre16">``` // $Cate是當前欄目的數據，該變量在列表頁、內容頁、欄目首頁模板存在 {hkcms:channel name="$Cate.id" type="peer" ismenu="1" currentstyle="btn-primary"} <a href="{$item.url}" class="btn {$item.currentstyle}">{$item.title}</a> {/hkcms:channel} ``` ``` - 獲取指定欄目、以及不存在時顯示：暫無數據 ``` <pre class="calibre16">``` {//獲取單條欄目信息} {hkcms:channel name="9" empty="暫無數據"} <h1 class="title">欄目標題：{$item.title}</h1> <p class="lead">欄目描述：{$item.seo_desc}</p> {/hkcms:channel} ``` ``` - currentstyle示例：獲取當前欄目高亮效果如下 ![](https://img.kancloud.cn/76/0f/760fb03666840184c63484b07a573cfc_233x225.png) 表示當前欄目是行業資訊，注意：你需要寫好定義好class樣式。代碼示例 ``` <pre class="calibre16">``` // 顯示高亮的class，默認是active {hkcms:channel type="top" ismenu="1" currentstyle="active" } // 只需要在class里面寫上{$item.currentstyle}，如果是當前欄目會有class="active" <a class="{$item.currentstyle}" >{$item.title}</a> {/hkcms:channel} ``` ``` - 排序與統計文檔數量 ``` <pre class="calibre16">``` // 排序 desc-倒序，asc-升序。istotal=1 開啟統計文檔數量 {hkcms:channel name="10" type="son" cache="7200" order="update_time desc" istotal="1"} <a href="{$item.url}" class="btn {$item.currentstyle}">{$item.title} 文檔數：{$item.total}</a> {/hkcms:channel} ``` ``` ## 數據字典注意：其中`$item`變量根據channel標簽id參數影響，默認是：$item 字段名說明調用方式id欄目ID{$[item.id](http://item.id)}model\_id模型ID{$item.model\_id}parent\_id所屬父級欄目ID{$item.parent\_id }type欄目類型，link: 外部鏈接, list：列表欄目，category：欄目首頁{$item.type}name欄目英文名稱{$[item.name](http://item.name)}title欄目中文名稱{$item.title}url鏈接地址{$item.url}fullurl帶域名的URL地址{$item.fullurl}image欄目縮略圖{$item.image}seo\_titleseo標題{$item.seo\_title}seo\_keywordsseo關鍵字{$item.seo\_keywords}seo\_descseo描述{$item.seo\_desc}ismenu是否是導航菜單，1-導航菜單，0-不是{$item.ismenu}targeta標簽跳轉方式,用于target="\_blank"屬性，有\_blank，\_self等{$item.target}weigh排序{$item.weigh}has\_childtrue 有下級，false 沒有下級{$item.has\_child}son\_child數組。擁有的下級欄目ID{$item.son\_child}currentstyle當前選中class，用于CSS文字高亮{$item.currentstyle}parent\_url上級欄目的URL地址{$item.parent\_url}lang語言標識{$item.lang}num列表分頁大小{$item.num}