Page._run() 是一個輕量級 jQuery 分頁元件,支援:
pageCallBack(pageNum))| 參數 | 型別 | 預設 | 說明 |
|---|---|---|---|
| displayId | string | "#pageBox" | 分頁輸出容器選擇器 |
| pagesize | number | 15 | 每頁筆數 |
| totalsize | number | 0 | 總資料筆數(必填) |
| curpage | number | 1 | 當前頁碼 |
| simple | boolean | false | true 時隱藏上一頁/下一頁 |
| type | number | 0 | 0=URL跳轉, 1=回調函數 |
| url | string | "" | 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
}
};
if (param.xxx != undefined) 模式,相容舊版 JS。if (url.indexOf("?")==-1) url += "?1=1" 確保後續 &page= 正確串接。curpage > totalpages 自動修正為最後一頁。.pageBox .pages a 等)。Promise 回調,整合 fetch 實現無刷新分頁。aria-label、role="navigation"。Page._run() 展示了傳統 jQuery 時代「物件字面量 + 字串拼接 HTML」的典型元件寫法。其智慧頁碼折疊邏輯(前段/中段/後段)至今仍具參考價值。現代專案可將其核心演算法提取,配合 Vue/React 元件化、TypeScript 型別系統重構為更易維護的分頁組件。