在做 Ajax 搜尋時,除了刷新結果列表,還需要一組能操作翻頁的分頁按鈕。這份程式碼示範如何用 jQuery 動態產生「第一頁/上一頁/頁碼/下一頁/最後一頁」的按鈕列,並在點擊時以 $.post 向後端請求對應頁面的資料。作者也坦言由於時間因素沒有包成 jQuery 外掛,通用性一般,但基本功能完整,適合初學者參考。
如下圖為第一頁的樣子:

下圖為最後一頁的樣子:

核心方法 pageingBtn() 接受六個參數:
pageIndex:目前第幾頁。maxPage:資料總共分成多少頁。btnSize:最多顯示幾個頁碼按鈕。pageSize:每頁筆數。keyWord:搜尋關鍵字。container:要塞入按鈕的容器選擇器。
function pageingBtn(pageIndex, maxPage, btnSize, pageSize, keyWord, container) {
var BtnList = '';
$(container).html('');
if (pageIndex != 1) {
BtnList += '<button value="1" class="firstPage"> 第一頁 </button>';
var prevPageIndex = ((pageIndex - 1) < 1 ? 1 : (pageIndex - 1));
BtnList += '<button value="' + prevPageIndex + '" class="prevPage"> 上一頁 第' + prevPageIndex + '頁</button>';
}
var pageIndexStyle = ' class="pageIndex"';
// 計算頁碼起始值,並避免出現負數或超出總頁數
var start = (pageIndex - (btnSize / 2 | 0) > 0) ? (pageIndex - (btnSize / 2 | 0)) : 1;
if ((start + btnSize) > maxPage) { start = maxPage - btnSize + 1; }
start = (start <= 0 ? 1 : start);
for (var i = start; i < start + btnSize; i++) {
if (i > maxPage) { break; }
if (i == pageIndex) {
BtnList += '<button value="' + i + '"' + pageIndexStyle + '> ' + i + ' </button>';
} else {
BtnList += '<button value="' + i + '"> ' + i + ' </button>';
}
}
if (pageIndex < maxPage) {
var nextPageIndex = ((pageIndex + 1) > maxPage ? maxPage : (pageIndex + 1));
BtnList += '<button value="' + nextPageIndex + '" class="nextPage"> 下一頁 第' + nextPageIndex + '頁 </button>';
BtnList += '<button value="' + maxPage + '" class="endPage"> 最後一頁 第' + maxPage + '頁 </button>';
}
$(container).append(BtnList);
}
按鈕產生後,用 jQuery UI 的 .button() 美化外觀,並為每顆按鈕掛上 click 事件;點擊時先顯示載入動畫,再以 $.post 把頁碼、每頁筆數、排序方式與關鍵字送到後端,回傳後重新渲染列表。
$(container).find("button").button().click(function () {
loadingimg();
$.post("/author/query/",
{
'pageIndex': $(this).val(),
'pageSize': pageSize,
'order': 'DESC',
'sort': '',
'KeyWords': keyWord
},
function (data) {
$("#SearchText").val(keyWord);
LoadBookList(data);
}
);
});
// 以 jQuery UI 圖示美化各按鈕
$(".nextPage").button({ icons: { secondary: "ui-icon-seek-next" }, text: false });
$(".prevPage").button({ icons: { primary: "ui-icon-seek-prev" }, text: false });
$(".endPage").button({ icons: { secondary: "ui-icon-seek-end" }, text: false });
$(".firstPage").button({ icons: { primary: "ui-icon-seek-start" }, text: false });
$(".pageIndex").css({ 'background': '#ff0000', 'color': '#ffffff' });
程式中特別處理了「最大顯示按鈕數大於實際頁數」時會出現負數頁碼的邊界問題,這是分頁元件常見的 bug,值得留意。若要正式導入專案,建議把這段邏輯抽成可傳入 callback 的 reusable 外掛,並將請求網址、參數欄位改為可設定,以提高通用性。