萬盛學電腦網

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

純 JavaScript 實現分頁表格:JSON 數據渲染完整教學

在前端開發中,處理大量表格數據時分頁功能不可或缺。本文將詳細介紹如何使用純 JavaScript(無依賴任何框架)實現一個基於 JSON 數據源的分頁表格,包含數據渲染、分頁邏輯與導航欄生成的完整代碼示例。

核心思路

整個實現圍繞三個核心要素:

  • 數據源:一個包含所有行數據的 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>

關鍵點解析

1. 數據與視圖分離

所有業務數據集中在 tableData 陣列,列配置集中在 columns,修改欄位或新增列只需調整配置,無需動邏輯代碼。

2. 高效的 DOM 操作

  • 使用 table.tBodies[0] 直接獲取 tbody,避免遍歷 rows 集合。
  • 用 innerHTML = '' 一次性清空,比逐行 deleteRow 快得多。
  • insertRow() / insertCell() 是原生表格 API,性能優於拼接 HTML 字符串。

3. 分頁邏輯健壯性

  • Math.ceil 確保總頁數向上取整。
  • Math.min(page * pageSize, totalNums) 防止最後一頁越界。
  • 導航鏈接在首尾頁自動降級為純文字,避免無效點擊。

進階擴展建議

  1. 排序功能:在 columns 中增加 sortable: true,點擊表頭觸發 tableData.sort() 後重繪。
  2. 異步加載:將 tableData 改為 fetch('/api/data').then(r => r.json()),載入時顯示 Loading 動畫。
  3. 響應式:配合 CSS overflow-x: auto 或將表格轉為卡片佈局適配移動端。
  4. TypeScript 重構:為 tableData、columns、splitPage 參數添加類型定義,提升可維護性。
  5. 常見問題 FAQ

    Q: 為什麼不直接用 document.write 或拼接 HTML 字符串?
    A: 字符串拼接易導致 XSS 風險,且大量字符串操作性能較差;原生 DOM API 更安全、瀏覽器優化更好。
    Q: 如何在表格外部跳轉到指定頁?
    A: 直接調用 splitPage(目標頁碼, pageSize) 即可,函數已做邊界檢查。
    Q: 數據量超過萬條怎麼辦?
    A: 建議改為「虛擬滾動」或「服務端分頁」,僅請求當前頁數據,避免一次性載入大量 JSON 導致主線程阻塞。

    掌握這套純 JS 分頁邏輯後,你可以輕鬆將其封裝為可複用的 ES Module 或 Web Component,在任何無框架項目中即插即用。

copyright © 萬盛學電腦網 all rights reserved