資料表格若能點擊標題列排序,閱讀效率會大幅提升。本文解析一套純 JavaScript 的表格排序實作,並示範如何用 jQuery 順手加上隔行變色。
只要給 table 加上 class="sortable" 並設定 id,程式就會自動把標題列的每個儲存格換成可點擊的連結:
<table id="myTable" class="sortable">
<thead>
<tr><th>名稱</th><th>日期</th><th>金額</th></tr>
</thead>
<tbody>...</tbody>
</table>
addEvent(window, "load", sortables_init);
var SORT_COLUMN_INDEX;
function sortables_init() {
if (!document.getElementsByTagName) return;
var tbls = document.getElementsByTagName("table");
for (var ti = 0; ti < tbls.length; ti++) {
var thisTbl = tbls[ti];
if (((' ' + thisTbl.className + ' ').indexOf("sortable") != -1) && thisTbl.id) {
ts_makeSortable(thisTbl);
}
}
}
用 ' ' + className + ' ' 前後補空白再比對,是為了避免 sortable-x 這種字串被誤判為含有 sortable。
function ts_makeSortable(table) {
var firstRow = table.rows && table.rows.length > 0 ? table.rows[0] : null;
if (!firstRow) return;
for (var i = 0; i < firstRow.cells.length; i++) {
var cell = firstRow.cells[i];
var txt = ts_getInnerText(cell);
cell.innerHTML = '<a href="#" class="sortheader"'
+ ' onclick="ts_resortTable(this, ' + i + ');return false;">'
+ txt + '<span class="sortarrow"> </span></a>';
}
}
每個 th 的內容被換成一個帶有 sortarrow span 的連結,那個 span 稍後用來放上下箭頭符號,表示目前的排序方向。
排序需要比較文字,但儲存格裡可能有巢狀標籤,因此要自己寫一個遞迴的取文字函式:
function ts_getInnerText(el) {
if (typeof el == "string") return el;
if (typeof el == "undefined") return el;
if (el.innerText) return el.innerText; // IE 快速路徑
var str = "";
var cs = el.childNodes;
for (var i = 0; i < cs.length; i++) {
switch (cs[i].nodeType) {
case 1: str += ts_getInnerText(cs[i]); break; // 元素節點,遞迴
case 3: str += cs[i].nodeValue; break; // 文字節點
}
}
return str;
}
現代寫法可以直接用 el.textContent 取代整段,這也是當年跨瀏覽器 necessity 下的產物。
function ts_resortTable(lnk, clid) {
var span;
for (var ci = 0; ci < lnk.childNodes.length; ci++) {
if (lnk.childNodes[ci].tagName
&& lnk.childNodes[ci].tagName.toLowerCase() == 'span') {
span = lnk.childNodes[ci];
}
}
var td = lnk.parentNode;
var column = clid || td.cellIndex;
var table = getParent(td, 'TABLE');
var tableid = $(table).attr("id");
if (table.rows.length <= 1) return;
// 看第二列第一格長什麼樣,推測這一欄的型別
var itm = ts_getInnerText(table.rows[1].cells[column]);
var sortfn = ts_sort_caseinsensitive;
if (itm.match(/^\d\d[\/-]\d\d[\/-]\d\d\d\d$/)) sortfn = ts_sort_date;
if (itm.match(/^\d\d[\/-]\d\d[\/-]\d\d$/)) sortfn = ts_sort_date;
if (itm.match(/^[$]/)) sortfn = ts_sort_currency;
if (itm.match(/^[\d\.]+$/)) sortfn = ts_sort_numeric;
SORT_COLUMN_INDEX = column;
var newRows = [];
for (var j = 1; j < table.rows.length; j++) newRows[j - 1] = table.rows[j];
newRows.sort(sortfn);
// 切換排序方向
if (span.getAttribute("sortdir") == 'down') {
newRows.reverse();
span.setAttribute('sortdir', 'up');
} else {
span.setAttribute('sortdir', 'down');
}
// appendChild 已存在的節點會「搬移」而非複製
for (var i = 0; i < newRows.length; i++) {
if (!newRows[i].className
|| newRows[i].className.indexOf('sortbottom') == -1) {
table.tBodies[0].appendChild(newRows[i]);
}
}
for (var i = 0; i < newRows.length; i++) {
if (newRows[i].className && newRows[i].className.indexOf('sortbottom') != -1) {
table.tBodies[0].appendChild(newRows[i]); // 註腳列永遠留在最後
}
}
// 清掉其他欄位的箭頭
var allspans = document.getElementsByTagName("span");
for (var ci = 0; ci < allspans.length; ci++) {
if (allspans[ci].className == 'sortarrow'
&& getParent(allspans[ci], "table") == getParent(lnk, "table")) {
allspans[ci].innerHTML = ' ';
}
}
span.innerHTML = (span.getAttribute("sortdir") == 'down') ? ' ↓' : ' ↑';
// 用 jQuery 重套隔行變色
$('#' + tableid + ' tr:gt(0):even').css("background-color", "#FFF7E8");
$('#' + tableid + ' tr:gt(0):odd').css("background-color", "#CCE8CF");
}
// 日期:把 dd/mm/yyyy 正規化成 yyyymmdd 再比
function ts_sort_date(a, b) {
var aa = ts_getInnerText(a.cells[SORT_COLUMN_INDEX]);
var bb = ts_getInnerText(b.cells[SORT_COLUMN_INDEX]);
// 兩位數年份小於 50 視為 20XX,否則 19XX
// ...正規化後以字串比較即可
}
// 金額:拔掉非數字字元後轉 float
function ts_sort_currency(a, b) {
var aa = ts_getInnerText(a.cells[SORT_COLUMN_INDEX]).replace(/[^0-9.]/g, '');
var bb = ts_getInnerText(b.cells[SORT_COLUMN_INDEX]).replace(/[^0-9.]/g, '');
return parseFloat(aa) - parseFloat(bb);
}
// 數字
function ts_sort_numeric(a, b) {
var aa = parseFloat(ts_getInnerText(a.cells[SORT_COLUMN_INDEX]));
var bb = parseFloat(ts_getInnerText(b.cells[SORT_COLUMN_INDEX]));
if (isNaN(aa)) aa = 0;
if (isNaN(bb)) bb = 0;
return aa - bb;
}
// 不分大小寫的字串比較
function ts_sort_caseinsensitive(a, b) {
var aa = ts_getInnerText(a.cells[SORT_COLUMN_INDEX]).toLowerCase();
var bb = ts_getInnerText(b.cells[SORT_COLUMN_INDEX]).toLowerCase();
return (aa == bb) ? 0 : (aa < bb ? -1 : 1);
}
型別自動偵測:以第二列第一格的值配對正則,決定要用哪個比較函式。這個「用資料樣本推測型別」的思路,讓同一套程式能處理各種表格而不用手動指定。
sortbottom 類別:加上 class="sortbottom" 的列(例如「合計」)永遠排在最後,不會被排序打亂。這是很實際的表格設計考量。
appendChild 的搬移語意:把已存在於 DOM 的節點 appendChild 到同一個父元素下,瀏覽器會執行搬移而非複製。這是無需建立新節點就能完成排序的關鍵。
最後,若要在新專案實作同樣功能,其實不必自己寫。各家 Table 外掛(如 tablesorter)或現代前端框架的 table 元件都已處理好排序、多欄排序、無障礙 aria-sort 屬性等細節。手寫一遍的價值在於理解原理,而非重造輪子。