DIV CSS 佈局教程網

jQuery Pagination 分頁外掛(切換無刷新、無延遲)中文翻譯版介紹
編輯:JQuery特效代碼     

原專案網址:https://plugins.jquery.com/project/pagination
版本:v1.2
檔案下載:英文原版或中文翻譯修改版。

一、相關 demo

  • 基本 demo 頁面
  • Ajax demo 頁面
  • 參數可編輯 demo 頁面

二、簡介與特色

  • 這是一款以 Ajax 為基礎的分頁外掛,採一次性載入的方式,因此切換分頁時不會重新整理、也沒有等待延遲。不過若資料量龐大就不太建議,因為初次載入會比較慢。
  • 原版外掛的 CSS 使用浮動排版,較難靈活地做左右定位,而且沒有清除浮動;中文修改版對此做了優化,改以 text-align 來控制對齊。
  • 原始的 JS 註解已翻成中文,demo 頁面也做了中文化處理。demo 的 JS 與原版略有出入,但核心邏輯不變。

三、使用方法

用法和一般 jQuery 外掛一樣簡單,呼叫 `pagination` 方法即可,例如 `$("#page").pagination(100);`。這裡的 100 是必填參數,代表項目總數,是最基本的用法,效果如下:

另外值得一提的是,分頁列表需要放在 class 為 pagination 的標籤內,你可以用 text-align 屬性決定分頁要置中還是靠右。

回呼函式通常用來載入對應分頁的內容,細節可參考 demo 原始碼。

四、參數說明

  • maxentries:總條目數,必填整數。
  • items_per_page:每頁顯示的條目數,選填,預設 10。
  • num_display_entries:分頁主體連續顯示的頁碼數,選填,預設 10。
  • current_page:當前選取的頁碼,選填,預設 0(即第一頁)。
  • num_edge_entries:兩側顯示的頭尾頁碼數,選填,預設 0。
  • link_to:分頁的連結,字串,選填,預設 "#"。
  • prev_text/next_text:「上一頁」「下一頁」按鈕文字,選填,預設 Prev/Next。
  • ellipse_text:省略頁碼時顯示的文字,選填,預設 "…"。
  • prev_show_always/next_show_always:是否總是顯示上一頁/下一頁按鈕,布林值,預設 true。
  • callback:回呼函式,預設無作用。

五、使用範例

$("#Pagination").pagination(56, {
    num_edge_entries: 2,
    num_display_entries: 4,
    callback: pageselectCallback,
    items_per_page: 1
});

這段程式碼代表:總共 56 個列表項,頭尾兩側各顯示 2 個頁碼,主體連續顯示 4 個頁碼,回呼函式為 pageselectCallback,每頁顯示 1 個項目。你可以對照參數表自行調整。

六、關於 demo 的補充

三個 demo 各有側重:第一個是靜態資料直接寫在 HTML 上;第二個用 Ajax 載入 HTML 資料再分頁;第三個則可動態修改參數、即時觀察效果。

所有 demo 的 JS 註解都改成了中文。真正的難點在回呼函式,它有兩個參數:page_index 代表目前點擊頁碼的索引值,jq 則是承載容器。關鍵就在 page_index——我們得靠它找到對應的 HTML 元素,再放進指定容器中顯示。demo 裡同時示範了單元素與多元素的載入方式,照著做應該沒太大問題。

大致就是這樣。如果發現描述不夠精準,或想交流相關問題,歡迎透過評論或到專案頁面提問。(本篇完)

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved