一個功能完整的資料表格,通常會需要四件事:點標題排序、點儲存格就地編輯、拖曳邊界調整欄寬、拖曳整欄改變順序。以下拆解這四個機制的實作要點。
<!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 不該當資料庫」這兩課,做任何互動元件都用得上。