pagination.js 是早期相當常見的客戶端分頁外掛。它的運作方式是:一次把全部資料(JSON)載入前端,再由外掛切出目前這一頁要顯示的部分,並透過 callback 讓你去決定「換頁時要做什麼」。

<link rel="stylesheet" href="pagination.css">
<script type="text/javascript" src="jquery.min.js"></script>
<script type="text/javascript" src="jquery.pagination.js"></script>
<div class="pagination"></div>
<script>
function pageselectCallback(page_index, jq) {
alert(page_index);
return false; // 回傳 false 阻止預設行為
}
$(document).ready(function () {
$(".pagination").pagination(100, { // 100 = 總筆數
callback: pageselectCallback,
num_edge_entries: 1
});
});
</script>
第一個參數是總記錄數,外掛用它配合每頁筆數算出總頁數。
| 參數 | 說明 | 預設值 |
|---|---|---|
| callback | 點擊頁碼時的回呼函式 | function(){return false;} |
| current_page | 初始選中的頁碼 | 0 |
| items_per_page | 每頁顯示幾筆 | 10 |
| link_to | 分頁連結的 href | # |
| num_display_entries | 最多顯示幾個頁碼 | 11 |
| next_text | 「下一頁」的文字 | Next |
| next_show_always | 設為 false 時,只有還能往後翻才顯示 | true |
| prev_text | 「上一頁」的文字 | Previous |
| prev_show_always | 設為 false 時,只有還能往前翻才顯示 | true |
| num_edge_entries | 設為 1 則永遠顯示首頁與末頁 | 0 |
| ellipse_text | 省略區間的標示字串 | … |
| load_first_page | 設為 true 時,初始化就會觸發 callback | true |
資料是一次性全部讀進瀏覽器的。筆數少時沒問題,但幾千筆以上就會造成明顯的初次載入延遲,而且把全部資料送到前端本身也有資安疑慮——不想讓使用者看到的內容,就不該出現在前端。
它的 callback 設計其實已經預留了接後端的空間:在 callback 裡發 AJAX 請求,只取目前頁的資料回來渲染即可。真正的分頁應該永遠是伺服器端的,用 LIMIT ... OFFSET ... 或 cursor-based 查詢,搭配 fetch 更新畫面。
不需要外掛也能做出完整分頁。核心就是算頁碼:
function renderPager(total, page, perPage) {
var pages = Math.ceil(total / perPage);
var html = '';
for (var i = 1; i <= pages; i++) {
html += '<button type="button" data-page="' + i + '"' +
(i === page ? ' aria-current="page" disabled' : '') + '>' + i + '</button>';
}
return html;
}
記得標示 aria-current="page" 讓輔具知道目前位置,並用 <nav aria-label="分頁導覽"> 包住整組按鈕。資料量真的很大時,改用無限捲動或「載入更多」按鈕,通常比翻頁更符合行動裝置的使用習慣。