功能需求
- 根據當前頁、總頁數、最大顯示按鈕數動態生成分頁
- 首頁、末頁、上一頁、下一頁、頁碼按鈕
- 當前頁高亮、邊界自動收斂
- 點擊觸發 AJAX 重新載入列表
- 使用 jQuery UI Button 樣式美化
核心函數:pageingBtn
/**
* 生成分頁按鈕
* @param {number} pageIndex 當前頁 (1-based)
* @param {number} maxPage 總頁數
* @param {number} btnSize 最大顯示頁碼按鈕數
* @param {number} pageSize 每頁條數 (傳給回調)
* @param {string} keyWord 搜尋關鍵詞
* @param {string} container 容器選擇器
*/
function pageingBtn(pageIndex, maxPage, btnSize, pageSize, keyWord, container) {
let btnList = "";
$(container).empty();
// 首頁、上一頁
if (pageIndex !== 1) {
btnList += '<button value="1" class="firstPage">第一頁</button>';
const prev = pageIndex - 1;
btnList += `<button value="${prev}" class="prevPage">上一頁 第${prev}頁</button>`;
}
// 頁碼範圍計算:以當前頁為中心,左右均分
let start = pageIndex - Math.floor(btnSize / 2);
if (start < 1) start = 1;
if (start + btnSize - 1 > maxPage) start = maxPage - btnSize + 1;
if (start < 1) start = 1;
// 頁碼按鈕
for (let i = start; i <= maxPage && i < start + btnSize; i++) {
const cls = (i === pageIndex) ? "pageIndex" : "";
btnList += `<button value="${i}" class="${cls}">第${i}頁</button>`;
}
// 下一頁、末頁
if (pageIndex !== maxPage) {
const next = pageIndex + 1;
btnList += `<button value="${next}" class="nextPage">下一頁 第${next}頁</button>`;
btnList += `<button value="${maxPage}" class="lastPage">最後一頁</button>`;
}
$(container).html(btnList).find("button").button(); // jQuery UI 美化
// 綁定點擊事件(事件委派)
$(container).off("click", "button").on("click", "button", function() {
const newPage = parseInt(this.value, 10);
if (newPage !== pageIndex) {
loadSearchResults(newPage, pageSize, keyWord); // 業務回調
}
});
}
邊界計算邏輯圖解
maxPage=20, btnSize=5, pageIndex=1
→ start=1 → [1,2,3,4,5]
pageIndex=3
→ start=1 → [1,2,3,4,5] (左側不足)
pageIndex=10
→ start=8 → [8,9,10,11,12] (置中)
pageIndex=19
→ start=16 → [16,17,18,19,20] (右側收斂)
pageIndex=20
→ start=16 → [16,17,18,19,20]
CSS 樣式建議
.ui-button { margin: 0 2px; padding: 4px 10px; }
.pageIndex { background: #007bff !important; color: #fff !important; font-weight: bold; }
.firstPage, .lastPage { font-weight: bold; }
業務整合範例
let currentPage = 1;
const PAGE_SIZE = 10;
const MAX_BTNS = 7;
function loadSearchResults(page, pageSize, keyword) {
currentPage = page;
$.ajax({
url: "/api/search",
data: { q: keyword, page, size: pageSize },
dataType: "json",
success: function(res) {
renderResults(res.data); // 渲染列表
pageingBtn(page, res.totalPages, MAX_BTNS, pageSize, keyword, "#pager");
}
});
}
// 首次載入
$("#searchBtn").on("click", function() {
const kw = $("#keyword").val();
loadSearchResults(1, PAGE_SIZE, kw);
});
進階優化方向
- 防抖/節流:快速點擊時避免重複請求
- 載入狀態:按鈕 disabled + loading 圖標
- 無限滾動替代:移動端體驗更佳
- URL 狀態同步:
history.pushState 記錄頁碼,支援分享/重整
- 無障礙:
role="navigation"、aria-label、鍵盤操作