在前端開發中,處理大量表格數據時分頁功能不可或缺。本文將詳細介紹如何使用純 JavaScript(無依賴任何框架)實現一個基於 JSON 數據源的分頁表格,包含數據渲染、分頁邏輯與導航欄生成的完整代碼示例。
整個實現圍繞三個核心要素:
tableData)。columns)。splitPage(page, pageSize),負責根據當前頁碼與每頁條數,計算切片範圍、重繪 tbody 並更新分頁導航條。以下為可直接在瀏覽器運行的完整 HTML 頁面,已內嵌樣本數據與樣式:
<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="UTF-8">
<title>純 JS 分頁表格示例</title>
<style>
table { border-collapse: collapse; width: 100%; font-family: sans-serif; }
th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
th { background: #f4f4f4; }
#page_bar { margin-top: 12px; font-size: 14px; }
#page_bar a { margin: 0 4px; color: #0066cc; text-decoration: none; }
#page_bar a:hover { text-decoration: underline; }
</style>
</head>
<body>
<table id="page_table">
<thead>
<tr><th>區縣</th><th>客戶總收入</th><th>當月出賬費用</th></tr>
</thead>
<tbody></tbody>
</table>
<div id="page_bar"></div>
<script>
// 1. 模擬後端返回的 JSON 數據
const tableData = [
{"C0":"臨夏州_康樂縣","C1":190893.39,"C2":24544.65,"AREA_ID":"930013005"},
{"C0":"臨夏州_永靖縣","C1":368900.35,"C2":40592.19,"AREA_ID":"930013006"},
{"C0":"蘭州市_東崗分局","C1":88.48,"C2":126.4,"AREA_ID":"930013106"},
{"C0":"臨夏州_臨夏縣","C1":107337.9,"C2":20612.1,"AREA_ID":"930013008"},
{"C0":"臨夏州_廣河縣","C1":69738.07,"C2":34894.44,"AREA_ID":"930013003"},
{"C0":"臨夏州_和政縣","C1":46622.96,"C2":20954.97,"AREA_ID":"930013002"},
{"C0":"臨夏州_東鄉縣","C1":96021.84,"C2":16725.63,"AREA_ID":"930013004"},
{"C0":"臨夏州_臨夏市中心","C1":1845311.12,"C2":129478.93,"AREA_ID":"930013001"},
{"C0":"天水市_秦州區","C1":0,"C2":0,"AREA_ID":"930013801"},
{"C0":"臨夏州_積石山","C1":256181.79,"C2":15185.98,"AREA_ID":"930013007"},
{"C0":"酒泉_肅州區","C1":264312,"C2":402.6,"AREA_ID":"930013701"}
];
// 2. 列配置:cid 對應數據字段,ctext 為表頭顯示文字
const columns = [
{"cid":"C0", "ctext":"區縣"},
{"cid":"C1", "ctext":"客戶總收入"},
{"cid":"C2", "ctext":"當月出賬費用"}
];
// 3. 分頁核心函數
function splitPage(page, pageSize) {
const table = document.getElementById("page_table");
const tbody = table.tBodies[0] || table.createTBody();
// 清空現有 tbody 內容
tbody.innerHTML = "";
const totalNums = tableData.length;
const totalPage = Math.ceil(totalNums / pageSize);
const begin = (page - 1) * pageSize;
const end = Math.min(page * pageSize, totalNums);
// 填充數據行
for (let i = begin; i < end; i++) {
const row = tbody.insertRow();
const rowData = tableData[i];
columns.forEach(col => {
const cell = row.insertCell();
cell.textContent = rowData[col.cid];
});
}
// 生成分頁導航條
let pageBar = `第 ${page} 頁 / 共 ${totalPage} 頁 `;
const addLink = (txt, p) => `<a href="javascript:splitPage(${p},${pageSize})">${txt}</a> `;
pageBar += page > 1 ? addLink("首頁", 1) : "首頁 ";
pageBar += page > 1 ? addLink("上一頁", page - 1) : "上一頁 ";
pageBar += page < totalPage ? addLink("下一頁", page + 1) : "下一頁 ";
pageBar += page < totalPage ? addLink("尾頁", totalPage) : "尾頁 ";
document.getElementById("page_bar").innerHTML = pageBar;
}
// 頁面載入時初始化:第 1 頁,每頁 3 條
window.onload = () => splitPage(1, 3);
</script>
</body>
</html>
所有業務數據集中在 tableData 陣列,列配置集中在 columns,修改欄位或新增列只需調整配置,無需動邏輯代碼。
table.tBodies[0] 直接獲取 tbody,避免遍歷 rows 集合。innerHTML = '' 一次性清空,比逐行 deleteRow 快得多。insertRow() / insertCell() 是原生表格 API,性能優於拼接 HTML 字符串。Math.ceil 確保總頁數向上取整。Math.min(page * pageSize, totalNums) 防止最後一頁越界。columns 中增加 sortable: true,點擊表頭觸發 tableData.sort() 後重繪。tableData 改為 fetch('/api/data').then(r => r.json()),載入時顯示 Loading 動畫。overflow-x: auto 或將表格轉為卡片佈局適配移動端。tableData、columns、splitPage 參數添加類型定義,提升可維護性。document.write 或拼接 HTML 字符串?splitPage(目標頁碼, pageSize) 即可,函數已做邊界檢查。掌握這套純 JS 分頁邏輯後,你可以輕鬆將其封裝為可複用的 ES Module 或 Web Component,在任何無框架項目中即插即用。