contentpage 內容列表分頁 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# contentpage 內容列表分頁 ## 內容列表分頁標簽生成頁碼的分頁標簽，需要配合內容列表標簽使用 > 2.1.220220版本起，新增：可用于內容頁，對內容分頁 ## 格式示例 ``` <pre class="calibre16">``` {hkcms:contentpage item="home,pre,pageno,next,last,info,jump" /} ``` ``` ## 參數參數名稱可選值默認值是否必填說明itemhome-首頁, pre-上一頁, pageno-頁碼, next-下一頁, last-尾頁, info-數量信息, jump-跳轉頁碼-是分頁格式mobile\_item同上--手機端時顯示的頁碼格式，該參數有值時，item則失效。注意：只有在移動端時才有效size-5-顯示頁碼數量。home-首頁-首頁按鈕顯示的文字。pre-上一頁-上一頁按鈕顯示的文字。next-下一頁-下一頁按鈕顯示的文字。last-尾頁-尾頁按鈕顯示的文字。info-共 %s 頁 / %s 條數據-更改默認數量顯示信息，第一個%s是總頁數，第二個%s是總條數emptxt-共 %s 頁 / %s 條數據-不夠分頁時顯示提示信息hasemptrue/falsetrue-true-顯示提示信息，false-不顯示## 參數說明 `item` 屬性用于控制分頁顯示項，如下圖所示 ![](https://img.kancloud.cn/8a/a4/8aa489f7b2fa63246c14020e8691a39c_831x220.png) 1. 只顯示上一頁下一頁按鈕。 ``` <pre class="calibre16">``` {hkcms:contentpage item="pre,next" /} ``` ``` `mobile_item`屬性與`item`一致，區別在于僅控制移動端的顯示 ``` <pre class="calibre16">``` // 移動端只顯示上一頁、頁碼與下一頁 {hkcms:contentpage item="pre,next,last,info,jump" mobile_item="pre,pageno,next" /} ``` ``` `size`控制頁碼數量，至少五個頁碼。 ``` <pre class="calibre16">``` {hkcms:contentpage item="pre,next,last,info,jump,pageno" size="6" /} ``` ``` `home` 控制首頁按鈕文字，例如首頁文字改成字體圖標 ``` <pre class="calibre16">``` // 注意：home="" 里面不能出現雙引號、'fa fa-home 是fontawesome圖標庫 {hkcms:contentpage item="home,pre,next,last,pageno" home="" /} ``` ``` ![](https://img.kancloud.cn/b9/a3/b9a35f0824e2d619563fadbc00e3cfd0_437x102.png) `pre`控制上一頁按鈕文字、`next`控制下一頁按鈕文字、`last`控制尾頁按鈕文字、設置方法同上一致 `info` 屬性是控制分頁信息。默認格式為：**共 %s 頁 / %s 條數據**，第一個%s是總頁數，第二個%s是總條數，例如上面圖片中的**共 2 頁 11 條數據** 例如：分頁信息改為：共 2 頁,總共 11 個產品 ``` <pre class="calibre16">``` {hkcms:contentpage item="pre,next,pageno,info" info="共 %s 頁,總共 %s 個產品" /} ``` ``` `emptxt`屬性是對不夠分頁顯示的提示信息，如下 ![](https://img.kancloud.cn/9f/d3/9fd3de9083e954d0a86393a200675142_184x73.png) 修改方式同上 `hasemp`屬性是對不夠分頁的提示信息控制顯示隱藏，true-顯示提示信息，false-不顯示 ``` <pre class="calibre16">``` // 默認顯示，hasemp="false" 為隱藏 {hkcms:contentpage item="pre,next,pageno,info" hasemp="false" /} ``` ``` ## 示例 - 完整示例每頁顯示10條記錄 ``` <pre class="calibre16">``` // 結合內容列表標簽 {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樣式定義分頁風格。根據自己的需要，可自定義分頁顯示的項。 ![](https://img.kancloud.cn/94/55/94555c4bbbb463ca1990b8999cdc758e_686x171.png) - 移動端覆蓋默認的格式如下代碼所示，在移動端是，mobile\_item覆蓋item格式。移動端只顯示上一頁，頁碼，下一頁。 ``` <pre class="calibre16">``` {hkcms:contentpage item="home,pre,pageno,next,last,info" mobile_item="pre,pageno,next" pre="«" next="»" /} ``` ``` - 修改不夠分頁提示信息默認顯示共1頁，1條數據，使用emptxt屬性，可修改 ``` <pre class="calibre16">``` {hkcms:contentpage item="pre,pageno,next" mobile_item="pre,pageno,next" emptxt="共%s頁" pre="«" next="»" /} ``` ``` - 隱藏不夠分頁的提示信息。使用hasemp參數 ``` <pre class="calibre20">``` {hkcms:contentpage item="pre,pageno,next" mobile_item="pre,pageno,next" hasemp="true" pre="«" next="»" /} ``` ```