原專案網址:https://plugins.jquery.com/project/pagination
版本:v1.2
檔案下載:英文原版或中文翻譯修改版。
一、相關 demo
二、簡介與特色
三、使用方法
用法和一般 jQuery 外掛一樣簡單,呼叫 `pagination` 方法即可,例如 `$("#page").pagination(100);`。這裡的 100 是必填參數,代表項目總數,是最基本的用法,效果如下:
另外值得一提的是,分頁列表需要放在 class 為 pagination 的標籤內,你可以用 text-align 屬性決定分頁要置中還是靠右。
回呼函式通常用來載入對應分頁的內容,細節可參考 demo 原始碼。
四、參數說明
五、使用範例
$("#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 裡同時示範了單元素與多元素的載入方式,照著做應該沒太大問題。
大致就是這樣。如果發現描述不夠精準,或想交流相關問題,歡迎透過評論或到專案頁面提問。(本篇完)