# taglist標簽(獲取標簽列表) ## taglist標簽 用于**獲取標簽列表** > HkCms\_2.2.4.230206版本起 ## 參數 參數名稱可選值默認值是否必填說明tid標簽ID或0--0-表示獲取所有arcid文章ID-tid與arcid選一個獲取指定文章包含的標簽model模型ID-acrid填寫時，該值不能為空指定標簽屬于的模型catid欄目ID--指定標簽屬于的欄目order-views desc（點擊量降序）-排序num---限制結果數量where---sql篩選條件page1--開啟分頁，配合 {hkcms:contentpage /} 分頁標簽id-$item-指定循環里的變量名，例如id='obj'，模板調用如：{$item.title} 變成 {$obj.title}empty--否為空的時候輸出提示，支持傳入htmlcache-3600秒-緩存時間，默認3600秒currentstyle-active-css class 類名，用于定義當前選擇狀態樣式## 簡單示例 1\. 獲取所有標簽 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist tid<span class="token">=</span><span class="token4">"0"</span><span class="token1">}</span> <span class="token1">{</span>php<span class="token1">}</span><span class="token6">dump</span><span class="token1">(</span>$item<span class="token1">)</span><span class="token1">;</span><span class="token1">{</span><span class="token">/</span>php<span class="token1">}</span> <span class="token5">// 輸出所有字段</span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> ``` ``` 2\. 獲取指定標簽 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist tid<span class="token">=</span><span class="token4">"3"</span><span class="token1">}</span> <span class="token1">{</span>php<span class="token1">}</span><span class="token6">dump</span><span class="token1">(</span>$item<span class="token1">)</span><span class="token1">;</span><span class="token1">{</span><span class="token">/</span>php<span class="token1">}</span> <span class="token5">// 輸出所有字段</span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> ``` ``` 3\. 文章詳情頁，獲取當前文章所有標簽，也可用于列表頁 詳情頁： ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist arcid<span class="token">=</span><span class="token4">"$Info.id"</span> model<span class="token">=</span><span class="token4">"$Info.model_id"</span><span class="token1">}</span> <span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span><span class="token">></span><span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> ``` ``` 4\. 只獲取特定模型的標簽 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist model<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span> <span class="token1">{</span>php<span class="token1">}</span><span class="token6">dump</span><span class="token1">(</span>$item<span class="token1">)</span><span class="token1">;</span><span class="token1">{</span><span class="token">/</span>php<span class="token1">}</span> <span class="token5">// 輸出所有字段</span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> ``` ``` 5\. 只獲取特定欄目的標簽（1.0.3版本） ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist catid<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span> <span class="token1">{</span>php<span class="token1">}</span><span class="token6">dump</span><span class="token1">(</span>$item<span class="token1">)</span><span class="token1">;</span><span class="token1">{</span><span class="token">/</span>php<span class="token1">}</span> <span class="token5">// 輸出所有字段</span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> ``` ``` 5\. 分頁,page=1:開啟分頁，num=10，每頁顯示10條記錄 ``` <pre class="calibre20">``` <span class="token1">{</span>hkcms<span class="token1">:</span>taglist tid<span class="token">=</span><span class="token4">"0"</span> page<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"10"</span> order<span class="token">=</span><span class="token4">"views desc"</span><span class="token1">}</span> <span class="token"><</span>div class<span class="token">=</span><span class="token4">"col-xs-3"</span><span class="token">></span> <span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> target<span class="token">=</span><span class="token4">"_blank"</span><span class="token">></span><span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span> <span class="token"><</span><span class="token">/</span>div<span class="token">></span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>taglist<span class="token1">}</span> <span class="token5">// 顯示頁碼</span> <span class="token1">{</span>hkcms<span class="token1">:</span>contentpage item<span class="token">=</span><span class="token4">"home,pre,pageno,next,last,info"</span> mobile_item<span class="token">=</span><span class="token4">"pre,pageno,next"</span> pre<span class="token">=</span><span class="token4">"&laquo;"</span> next<span class="token">=</span><span class="token4">"&raquo;"</span> <span class="token">/</span><span class="token1">}</span> ``` ```