萬盛學電腦網

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

jQuery 分頁元件 Page._run() 完整用法與原始碼解析

元件簡介

Page._run() 是一個輕量級 jQuery 分頁元件,支援:

  • 自動計算總頁數、當前頁、上一頁/下一頁
  • 兩種模式:URL 跳轉(type=0)與 回調函數(type=1,需頁面定義 pageCallBack(pageNum))
  • 智慧型頁碼顯示:首尾頁、當前頁附近、省略號折疊
  • 可自訂容器 ID、每頁筆數、簡易模式(隱藏上下頁)

參數說明

參數型別預設說明
displayIdstring"#pageBox"分頁輸出容器選擇器
pagesizenumber15每頁筆數
totalsizenumber0總資料筆數(必填)
curpagenumber1當前頁碼
simplebooleanfalsetrue 時隱藏上一頁/下一頁
typenumber00=URL跳轉, 1=回調函數
urlstring""type=0 時的基礎網址

呼叫範例

// 範例 1:URL 跳轉模式
Page._run({
    totalsize: 300,
    curpage: 11,
    url: "list.php",
    pagesize: 20
});

// 範例 2:回調模式(需頁面定義 pageCallBack(pageNum))
Page._run({
    totalsize: 300,
    curpage: 11,
    type: 1,
    simple: true
});

核心原始碼解析

var Page = {
    _run: function(param) {
        // 1. 參數預設值合併
        var totalpages = 1,
            displayId  = "#pageBox",
            pagesize   = 15,
            totalsize  = 0,
            curpage    = 1,
            url        = "",
            type       = 0,
            simple     = false;

        // ... 參數覆寫邏輯 ...

        // 2. 計算總頁數
        if (totalsize > 0) {
            totalpages = this._getTotalPages(totalsize, pagesize);
            if (curpage > totalpages) curpage = totalpages;
        }

        // 3. 總頁數 > 1 才渲染
        if (totalpages > 1) {
            var pages = [];
            var firstPage = simple ? "" : this._builderPageArea(type, "up", url, curpage-1, "上一頁", false, displayId);
            var lastPage  = simple ? "" : this._builderPageArea(type, "down", url, curpage+1, "下一頁", false, displayId);

            // 4. 智慧頁碼生成邏輯
            if (curpage <= 4) {               // 前段:顯示 1~5 頁 + ... + 尾頁
                if (curpage != 1) pages.push(firstPage);
                if (totalpages > 5) {
                    for (var i=1; i<=5; i++) {
                        pages.push(this._builderPageArea(type, "", url, i, i, curpage===i, displayId));
                    }
                    pages.push('...');
                    pages.push(this._builderPageArea(type, "", url, totalpages, totalpages, false, displayId));
                } else {                      // 總頁數 ≤ 5:全顯示
                    for (var i=1; i<=totalpages; i++) {
                        pages.push(this._builderPageArea(type, "", url, i, i, curpage===i, displayId));
                    }
                }
                if (curpage != totalpages) pages.push(lastPage);
            }
            else if (totalpages - curpage <= 4) { // 後段:首頁 + ... + 尾段5頁
                // ... 類似邏輯 ...
            }
            else {                            // 中段:首頁 + ... + 當前頁前後2頁 + ... + 尾頁
                // ... 類似邏輯 ...
            }

            // 5. 輸出至容器
            $(displayId).html(pages.join(''));
        }
    },

    _getTotalPages: function(total, size) {
        return Math.ceil(total / size);
    },

    _builderPageArea: function(type, cls, url, pageNum, text, isCurrent, displayId) {
        // 產生單一頁碼/上下頁的 HTML 字串
        // type=0 → text
        // type=1 → text
        // isCurrent=true → text
    }
};

關鍵設計亮點

  1. 參數預設值合併:使用 if (param.xxx != undefined) 模式,相容舊版 JS。
  2. URL 參數自動補齊:if (url.indexOf("?")==-1) url += "?1=1" 確保後續 &page= 正確串接。
  3. 邊界保護:curpage > totalpages 自動修正為最後一頁。
  4. 樣式解耦:僅產生結構 HTML,樣式完全由外部 CSS 控制(.pageBox .pages a 等)。

現代化改造建議

  • 改用 ES6 Class 語法、解構賦值、預設參數。
  • 支援 Promise 回調,整合 fetch 實現無刷新分頁。
  • 輸出虛擬 DOM / 模板字串,避免字串拼接錯誤。
  • 加入無障礙屬性 aria-label、role="navigation"。

總結

Page._run() 展示了傳統 jQuery 時代「物件字面量 + 字串拼接 HTML」的典型元件寫法。其智慧頁碼折疊邏輯(前段/中段/後段)至今仍具參考價值。現代專案可將其核心演算法提取,配合 Vue/React 元件化、TypeScript 型別系統重構為更易維護的分頁組件。

copyright © 萬盛學電腦網 all rights reserved