DIV CSS 佈局教程網

JS 表格元件四合一:排序、編輯、拖曳、縮放實作解析
編輯:關於JavaScript     

一個功能完整的資料表格,通常會需要四件事:點標題排序、點儲存格就地編輯、拖曳邊界調整欄寬、拖曳整欄改變順序。以下拆解這四個機制的實作要點。

基礎結構

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Table</title>
<style>
  body { font-size: 12px; }

  #tab { border-collapse: collapse; }

  /* 就地編輯的輸入框 */
  .edit {
    height: 16px; width: 98%;
    background-color: #EFF7FF;
    font-size: 12px; border: 0px;
  }

  #tab thead td {
    background: url(/upload/201005/20100531233452190.bmp);
    color: #183C94;
    cursor: pointer;         /* 提示這裡可以點擊排序 */
  }

  #tab tbody td {
    overflow: hidden;
    border: 1px solid #CECFCE;
    height: 20px; line-height: 20px;
    vertical-align: middle;
  }
  #tab td.tc { text-align: center; }

  /* 拖曳時顯示的對位輔助線 */
  .cc {
    width: 10px; height: 6px;
    border: 1px solid #999; background-color: #FFF;
    position: absolute; display: none;
  }
  #tab td.red { border-color: #f30; }

  /* 欄寬調整把手:貼在儲存格右緣的一條細線 */
  .ww {
    height: 100%; width: 1px;
    background: #CECFCE;
    float: right; margin-right: -1px;
    cursor: sw-resize;
  }

  .line {
    width: 2px; background-color: #999;
    position: absolute; display: none;
  }
</style>
</head>
<body>
  <table id="tab">
    <thead>
      <tr>
        <td>ID</td>
        <td>選中</td>
        <td>姓名</td>
        <td>生日</td>
        <td>備註</td>
      </tr>
    </thead>
    <tbody>
      <tr><td>1</td><td><input type="checkbox"></td><td>張三</td><td>1982-05-27</td><td>杯具,全是杯具</td></tr>
      <tr><td>3</td><td><input type="checkbox"></td><td>李四</td><td>1983-06-27</td><td>恩恩我魔獸技術不錯</td></tr>
      <tr><td>2</td><td><input type="checkbox"></td><td>王五</td><td>1983-05-27</td><td>波斯王子時之刃還不錯</td></tr>
      <tr><td>4</td><td><input type="checkbox"></td><td>趙六</td><td>1983-05-27</td><td>我叫趙六</td></tr>
      <tr><td>5</td><td><input type="checkbox"></td><td>朱八</td><td>1986-05-27</td><td>洗洗睡吧</td></tr>
    </tbody>
  </table>
</body>
</html>

一、點擊標題排序

排序的核心是把 tbody 的資料列取出成陣列、排序、再依序塞回去。要注意的是型別:ID 與生日該依字串或數字排,中文姓名則要用 localeCompare。

var tbody = document.getElementById('tab').tBodies[0];
var sortState = {};   // 記錄每欄目前的排序方向

function sortBy(colIndex) {
  var rows = Array.prototype.slice.call(tbody.rows);
  var asc = !sortState[colIndex];      // 第一次點擊為遞增

  rows.sort(function (a, b) {
    var x = a.cells[colIndex].textContent.trim();
    var y = b.cells[colIndex].textContent.trim();

    // 純數字欄位用數字比較,其餘用字串比較
    var r = (x !== '' && y !== '' && !isNaN(x) && !isNaN(y))
          ? Number(x) - Number(y)
          : x.localeCompare(y, 'zh-Hant');

    return asc ? r : -r;
  });

  // 排序後依序 appendChild,瀏覽器會自動搬移既有節點
  for (var i = 0; i < rows.length; i++) {
    tbody.appendChild(rows[i]);
  }

  sortState[colIndex] = asc;
}

// 掛到 thead 的每個 td
var heads = document.getElementById('tab').tHead.rows[0].cells;
for (var i = 0; i < heads.length; i++) {
  heads[i].onclick = (function (idx) { return function () { sortBy(idx); }; })(i);
}

這裡有兩個關鍵。第一,appendChild 對已經在 DOM 中的節點是「搬移」而非「複製」,所以直接依序 append 就能重排,不必先清空。第二,那個立即執行函數 (function(idx){...})(i) 是必要的——若直接用 i,所有 onclick 都會參照到迴圈結束後的最終值,點任何一欄都會排到最後一欄。

二、就地編輯

tbody.onclick = function (e) {
  var td = e.target;
  if (td.tagName !== 'TD') return;
  if (td.querySelector('.edit')) return;      // 已在編輯中

  var old = td.textContent;
  var input = document.createElement('input');
  input.type = 'text';
  input.className = 'edit';
  input.value = old;

  td.textContent = '';
  td.appendChild(input);
  input.focus();

  var done = false;
  function commit(save) {
    if (done) return;
    done = true;
    if (save) td.textContent = input.value;
    else      td.textContent = old;
  }

  input.onblur = function () { commit(true); };
  input.onkeydown = function (e) {
    if (e.key === 'Enter')  { commit(true);  }
    if (e.key === 'Escape') { commit(false); }
  };
};

這裡的 done 旗標很重要。按 Enter 時,commit 會把 input 從 DOM 移走(因為 td.textContent 被重新指派),而移除一個有焦點的元素會觸發 blur,於是 onblur 又呼叫一次 commit。少了這個旗標,就會出現「按 Enter 反而沒存到」的怪現象。

三、拖曳調整欄寬

每個 th 的右緣放一個 1px 寬的 .ww 元素當把手,滑鼠按下時記錄起點,移動時改 table 的宽度或該欄的 style:

function makeResizable(th) {
  var grip = document.createElement('span');
  grip.className = 'ww';
  th.appendChild(grip);

  grip.onmousedown = function (e) {
    e = e || window.event;
    e.preventDefault();
    e.stopPropagation();       // 別觸發排序

    var startX = e.clientX;
    var startW = th.offsetWidth;

    document.onmousemove = function (e) {
      e = e || window.event;
      th.style.width = Math.max(30, startW + e.clientX - startX) + 'px';
    };
    document.onmouseup = function () {
      document.onmousemove = document.onmouseup = null;
    };
    return false;
  };
}

要留意的是,表格欄寬在 CSS 中有其自身的計算規則(table-layout: auto 會依內容伸縮)。若希望 JS 設定的寬度被嚴格遵守,得在 table 上加 table-layout: fixed,否則拉寬之後可能又被內容擠回去。

四、拖曳排序

HTML5 有原生的拖曳 API,比手寫 mousedown 追蹤簡單得多:

var dragRow = null;

tbody.ondragstart = function (e) {
  // 只有整列可拖曳,儲存格內的勾選框不該啟動拖曳
  var tr = e.target.closest ? e.target.closest('tr') : null;
  if (!tr) return;
  dragRow = tr;
  tr.className = 'dragging';
  e.dataTransfer.effectAllowed = 'move';
};

tbody.ondragover = function (e) {
  e.preventDefault();     // 不 preventDefault 就不會觸發 drop
  e.dataTransfer.dropEffect = 'move';
};

tbody.ondrop = function (e) {
  e.preventDefault();
  var target = e.target.closest('tr');
  if (!dragRow || !target || dragRow === target) return;

  var rows = Array.prototype.slice.call(tbody.rows);
  if (rows.indexOf(dragRow) < rows.indexOf(target)) {
    tbody.insertBefore(dragRow, target.nextSibling);
  } else {
    tbody.insertBefore(dragRow, target);
  }
};

tbody.ondragend = function () {
  if (dragRow) dragRow.className = '';
  dragRow = null;
};

記得在 HTML 的 <tr> 上加 draggable="true",或者在 dragstart 之前用 JS 設定。

四件事共同的難題

把這四個功能放在一起,會出現幾個必須一併解決的問題,這也是原範例原始碼裡 .cc、.line、.red 這幾個 class 的用途。

事件衝突。 欄寬把手的 mousedown 必須 stopPropagation,否則會觸發排序;儲存格內的 checkbox 點擊不該進入編輯模式,要用 e.target.tagName 過濾。

狀態標示。 拖曳過程中要顯示對位輔助線(.line)或高亮目標列(.red),否則使用者不知道放開會插到哪裡。

排序後的狀態遺失。 排序會搬移 DOM 節點,若某些列正在編輯中,輸入框的狀態可能錯亂。實務上應在排序前先 commit 所有進行中的編輯。

資料與畫面的同步。 以上所有操作都只改了 DOM。若資料來源是伺服器,這些變更遲早要回寫;若資料來源是一個 JS 陣列,那麼 DOM 應該只是檢視,真正的排序與編輯都該作用在資料上,再重新渲染。後者才是長遠可維護的架構——把狀態放在 DOM 裡,功能一多就會難以收拾。

現代的答案很直接:這四件事在成熟表格元件(AG Grid、TanStack Table、DataTables 等)中都是內建功能,且已處理好鍵盤操作、無障礙、大量資料的虛擬捲動與效能問題。手寫版本的價值在於理解底層機制——特別是「事件冒泡如何造成衝突」與「DOM 不該當資料庫」這兩課,做任何互動元件都用得上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved