傳統分頁靠網址參數,每翻一頁整頁重載。若資料是透過 Ajax 取得的,翻頁時也希望不重新載入頁面,就需要把「分頁控制項」與「資料請求」綁在一起:點頁碼 → 抓該頁資料 → 更新列表與頁碼狀態。
先在需要分頁的位置放一個空的 ul,頁碼由插件動態生成:
<ul class="pagination" id="pageUl"></ul>
function paging(page) {
// 抓當前頁的資料
$.ajax({
type: "GET",
url: "${ctx}/api/v1/user/1/" + (page - 1) + "/5",
dataType: "json",
success: function (msg) {
// 省略:將 msg 渲染成列表
}
});
// 抓總筆數,用來算總頁數
$.ajax({
type: "GET",
url: "${ctx}/api/v1/user/count/1",
dataType: "json",
success: function (msg) {
var pages = Math.ceil(msg.data / 5); // 每頁 5 筆
var element = $('#pageUl');
var options = {
bootstrapMajorVersion: 3,
currentPage: page, // 當前頁
numberOfPages: 5, // 頁碼區顯示幾個按鈕
totalPages: pages // 總頁數
};
element.bootstrapPaginator(options);
}
});
}
注意 (page - 1) + "/5" 這段:頁碼從 1 起算,而後端 offset 從 0 起算,兩者相差一,轉換時最容易出錯。
插件預設只負責畫頁碼,點擊後要做什麼得自己接。修改 bootstrap-paginator.js 中的回呼:
onPageClicked: function (event, originalEvent, type, page) {
var currentTarget = $(event.currentTarget);
switch (type) {
case "first":
currentTarget.bootstrapPaginator("showFirst");
paging(page);
break;
case "prev":
currentTarget.bootstrapPaginator("showPrevious");
paging(page);
break;
case "next":
currentTarget.bootstrapPaginator("showNext");
paging(page);
break;
case "last":
currentTarget.bootstrapPaginator("showLast");
paging(page);
break;
case "page":
currentTarget.bootstrapPaginator("show", page);
paging(page);
break;
}
}
寫法很單純:type 指出使用者點的是首頁、上一頁、下一頁、末頁還是哪個頁碼,先讓插件更新視覺狀態,再呼叫 paging(page) 去抓資料。page 這個參數插件已經算好並傳進來了,直接轉傳即可,不必自己推算。
效果如下:

不要直接改插件原始檔。範例是直接在 bootstrap-paginator.js 裡動手,這在教學上最直觀,但專案裡一旦升級或多人協作,改動就會被覆蓋或遺漏。較好的做法是把 onPageClicked 當作 options 傳進初始化呼叫,例如 element.bootstrapPaginator($.extend(options, { onPageClicked: myHandler })),讓自訂邏輯留在自己的檔案裡。
兩次請求可以合併。總筆數在翻頁之間幾乎不變,沒必要每頁都打一次。第一次載入時取一次並快取,後續只抓當前頁資料即可,能少一半請求。
記得處理載入中與失敗狀態。Ajax 往返期間若不顯示提示,使用者容易重複點擊造成請求疊加;失敗時也應給出可重試的路徑,而不是讓列表停在舊資料上無聲無息。
每次刷新都重建頁碼。範例在每次 success 裡重新呼叫 bootstrapPaginator,這會重建整個 DOM。資料量大或點擊頻繁時,可考慮只更新 active 狀態而非整組重畫。