萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AJAX 搜尋結果分頁按鈕動態生成實現

功能需求

  • 根據當前頁、總頁數、最大顯示按鈕數動態生成分頁
  • 首頁、末頁、上一頁、下一頁、頁碼按鈕
  • 當前頁高亮、邊界自動收斂
  • 點擊觸發 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);
});

進階優化方向

  1. 防抖/節流:快速點擊時避免重複請求
  2. 載入狀態:按鈕 disabled + loading 圖標
  3. 無限滾動替代:移動端體驗更佳
  4. URL 狀態同步:history.pushState 記錄頁碼,支援分享/重整
  5. 無障礙:role="navigation"、aria-label、鍵盤操作
copyright © 萬盛學電腦網 all rights reserved