DIV CSS 佈局教程網

純 JavaScript 分頁:表格資料為 JSON 串的實作
編輯:JavaScript綜合知識     

當後端回傳的是一組 JSON 陣列,前端要自己做分頁時,可以完全不依賴任何框架。本文示範一個可重複呼叫的 splitPage 函式,同時完成資料渲染與分頁工具列產生。

資料與欄位定義

// 表格全部資料,可視為 action 查詢資料庫後得到的 JSON
var 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"}
];

// 欄位 key 與名稱的對應,也是 JSON 格式
var columns = [
  {"cid":"C0","ctext":"區縣"},
  {"cid":"C1","ctext":"客戶總收入"},
  {"cid":"C2","ctext":"當月出賬費用"}
];

分頁函式

除了 page(頁碼)與 pageSize(每頁幾筆),這個函式還依賴三個前提:表格的全部資料、欄位 key 與名稱的對應、以及表格的 id。此版本適用於「表頭只有一行且事先寫好」的情況。

/**
 * 分頁渲染
 * @param page     頁碼,從 1 開始
 * @param pageSize 每頁記錄條數
 */
function splitPage(page, pageSize) {
  var ptable = document.getElementById("page_table");
  var num = ptable.rows.length;      // table.rows 回傳所有列,此處含表頭 1 列

  // 清除 tbody 現有的資料列(保留表頭)
  for (var i = num - 1; i > 0; i--) {
    ptable.deleteRow(i);
  }

  var totalNums = tableData.length;             // 總筆數
  var totalPage = Math.ceil(totalNums / pageSize);  // 總頁數
  var begin = (page - 1) * pageSize;            // 起始索引(含)
  var end = page * pageSize;                    // 結束索引(不含)
  end = end > totalNums ? totalNums : end;

  // 向 tbody 寫入資料
  var n = 1;                                    // tbody 的起始列
  for (var i = begin; i < end; i++) {
    var row = ptable.insertRow(n++);
    var rowData = tableData[i];

    for (var j = 0; j < columns.length; j++) {
      var col = columns[j].cid;
      var cell = row.insertCell(j);
      cell.innerHTML = rowData[col];
    }
  }

  // 產生分頁工具列
  var pageBar = "第" + page + "頁/共" + totalPage + "頁" + " ";

  pageBar += page > 1
    ? '<a href="javascript:splitPage(1,' + pageSize + ');">首頁</a> '
    : "首頁 ";

  pageBar += page > 1
    ? '<a href="javascript:splitPage(' + (page - 1) + ',' + pageSize + ');">上一頁</a> '
    : "上一頁 ";

  pageBar += page < totalPage
    ? '<a href="javascript:splitPage(' + (page + 1) + ',' + pageSize + ');">下一頁</a> '
    : "下一頁 ";

  pageBar += page < totalPage
    ? '<a href="javascript:splitPage(' + totalPage + ',' + pageSize + ');">尾頁</a> '
    : "尾頁 ";

  document.getElementById("page_bar").innerHTML = pageBar;
}

HTML 結構

<body onload="splitPage(1,3);">
  <table id="page_table">
    <thead>
      <tr><th>區縣</th><th>客戶總收入</th><th>當月出賬費用</th></tr>
    </thead>
    <tbody></tbody>
  </table>

  <div id="page_bar"></div>
</body>

設計重點

  • deleteRow 從後往前刪:因為刪除會改變索引,若從 0 開始遞增刪,會跳過列。由後往前是標準解法。
  • columns 與資料分離:欄位定義獨立成設定,之後改欄位順序或增減欄位都不必動到邏輯。
  • 邊界處理:用 end = end > totalNums ? totalNums : end 避免最後一頁取到不存在的索引。

可以再加強的地方

  • 用 addEventListener 取代 javascript: 協定:inline 的 javascript: 連結在 CSP(Content-Security-Policy)下會被阻擋,也可能被使用者誤按右鍵開新分頁。改用 <button data-page="2"> 搭配事件委派。
  • innerHTML 有 XSS 風險:資料若來自外部,改用 textContent。
  • 資料量大時應後端分頁:一次載入全部資料再前端切頁,只適合幾百筆以內的情境;更大規模請把 page/pageSize 送到伺服器,只取當頁資料。
  • 可加上鍵盤與 aria 支援:為分頁連結加上 aria-label="第 2 頁",並讓目前頁有 aria-current="page"。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved