## 內容列表分頁標簽 生成頁碼的分頁標簽，需要配合內容列表標簽使用 <blockquote class="danger"><p>2.1.220220版本起，新增：可用于內容頁，對內容分頁</p></blockquote> ## 格式示例 ~~~ {hkcms:contentpage item="home,pre,pageno,next,last,info,jump" /} ~~~ ## 參數 | 參數名稱 | 可選值 | 默認值 | 是否必填 | 說明 | | --- | --- | --- | --- | --- | | item | home-首頁,<br>pre-上一頁,<br>pageno-頁碼,<br>next-下一頁,<br>last-尾頁,<br>info-數量信息,<br>jump-跳轉頁碼 | - | 是 | 分頁格式 | | mobile_item | 同上 | - | - | 手機端時顯示的頁碼格式，該參數有值時，item則失效。注意：只有在移動端時才有效 | | size | - | 5 | - | 顯示頁碼數量。 | | home | - | 首頁 | - | 首頁按鈕顯示的文字。 | | pre | - | 上一頁 | - | 上一頁按鈕顯示的文字。 | | next | - | 下一頁 | - | 下一頁按鈕顯示的文字。 | | last | - | 尾頁 | - | 尾頁按鈕顯示的文字。 | | info | - | <span>共 %s 頁 / %s 條數據</span> | - | 更改默認數量顯示信息，第一個%s是總頁數，第二個%s是總條數 | | emptxt | - | <span>共 %s 頁 / %s 條數據</span> | - | 不夠分頁時顯示提示信息 | | hasemp | true/false | true| - | 當列表不夠分頁時會顯示提示信息(跟item的info有區別)，true-顯示提示信息，false-不顯示 | ## 參數說明 `item` 屬性用于控制分頁顯示項，如下圖所示  1. 只顯示上一頁下一頁按鈕。 ~~~ {hkcms:contentpage item="pre,next" /} ~~~ `mobile_item`屬性與`item`一致，區別在于僅控制移動端的顯示 ~~~ // 移動端只顯示上一頁、頁碼與下一頁 {hkcms:contentpage item="pre,next,last,info,jump" mobile_item="pre,pageno,next" /} ~~~ `size`控制頁碼數量，至少五個頁碼。 ~~~ {hkcms:contentpage item="pre,next,last,info,jump,pageno" size="6" /} ~~~ `home` 控制首頁按鈕文字，例如首頁文字改成字體圖標 ~~~ // 注意：home="" 里面不能出現雙引號、'fa fa-home 是fontawesome圖標庫 {hkcms:contentpage item="home,pre,next,last,pageno" home="<i class='fa fa-home'></i>" /} ~~~  `pre`控制上一頁按鈕文字、`next`控制下一頁按鈕文字、`last`控制尾頁按鈕文字、設置方法同上一致 <br /> `info` 屬性是控制分頁信息。默認格式為：<span>**共 %s 頁 / %s 條數據**</span>，第一個%s是總頁數，第二個%s是總條數，例如上面圖片中的**共 2 頁 11 條數據** 例如：分頁信息改為：共 2 頁,總共 11 個產品 ~~~ {hkcms:contentpage item="pre,next,pageno,info" info="共 %s 頁,總共 %s 個產品" /} ~~~ `emptxt`屬性是對不夠分頁顯示的提示信息，如下  修改方式同上 `hasemp`屬性是對不夠分頁的提示信息控制顯示隱藏，true-顯示提示信息，false-不顯示 ~~~ // 默認顯示，hasemp="false" 為隱藏 {hkcms:contentpage item="pre,next,pageno,info" hasemp="false" /} ~~~ ## 示例 - 完整示例 每頁顯示10條記錄 ~~~ // 結合內容列表標簽 {hkcms:content catid="1" page="1" num="10"} <p>標題：{$item.title}</p> {/hkcms:content} <div> {hkcms:contentpage item="home,pre,pageno,next,last,info,jump" /} </div> ~~~ 結果圖，生成的html有帶class，可自行寫class樣式定義分頁風格。根據自己的需要，可自定義分頁顯示的項。  - 移動端覆蓋默認的格式 如下代碼所示，在移動端是，mobile_item覆蓋item格式。移動端只顯示上一頁，頁碼，下一頁。 ~~~ {hkcms:contentpage item="home,pre,pageno,next,last,info" mobile_item="pre,pageno,next" pre="&laquo;" next="&raquo;" /} ~~~ - 修改不夠分頁提示信息 默認顯示共1頁，1條數據，使用emptxt屬性，可修改 ~~~ {hkcms:contentpage item="pre,pageno,next" mobile_item="pre,pageno,next" emptxt="共%s頁" pre="&laquo;" next="&raquo;" /} ~~~ - 隱藏不夠分頁的提示信息。 使用hasemp參數 ~~~ {hkcms:contentpage item="pre,pageno,next" mobile_item="pre,pageno,next" hasemp="false" pre="&laquo;" next="&raquo;" /} ~~~