後台管理介面經常需要讓使用者自行增刪表格列,例如動態新增多筆明細資料。本文分享兩個簡短實用的函式。
/**
* 動態插入一列
* @param tableName table 的 id
* @param className 要套用的 CSS class
* @param bgcolor 該列的背景色
* @param cellContentArray 各欄位內容組成的陣列
*/
function insertRow(tableName, className, bgcolor, cellContentArray) {
var t = document.getElementById(tableName); // 取得 table
var tr = t.insertRow(); // 插入一列
tr.className = className; // 設定該列的 CSS
tr.bgcolor = bgcolor; // 設定背景色
for (var i = 0; i < cellContentArray.length; i++) {
var td = tr.insertCell(); // 插入一欄
td.innerHTML = cellContentArray[i]; // 設定欄位內容
}
}
/**
* 刪除指定的列
* @param tableName table 的 id
* @param btn 被點擊的刪除按鈕(位於該列內)
*/
function deleteRow(tableName, btn) {
var t = document.getElementById(tableName); // 取得 table
var tr = btn.parentNode.parentNode; // 由按鈕回溯到所在的 tr
t.deleteRow(tr.rowIndex);
}
這兩個函式刻意選用 DOM 的表格專屬 API 而非 innerHTML 拼字串,理由有三:
一、insertRow() 與 insertCell() 會自動處理 tbody 結構。瀏覽器解析 HTML 時會自動補上 tbody,若用 innerHTML 直接塞 tr,在部分舊版瀏覽器上會失效;改用這組 API 則跨瀏覽器行為一致。
二、rowIndex 是刪除的關鍵。deleteRow() 需要一個索引參數,而 tr.rowIndex 回傳的是該列在整個表格中的實際序號,因此不必自己維護計數器。
三、避免拼字串帶來的注入風險。若欄位內容來自使用者輸入,用 innerHTML 寫入等同直接執行 HTML。建議改用 td.appendChild(document.createTextNode(text)),只寫入純文字。
另外提醒,tr.bgcolor 是已棄用的屬性,正式專案請改用 tr.style.backgroundColor = bgcolor;而 btn.parentNode.parentNode 這種依賴 DOM 層級的寫法雖然簡潔,一旦日後在按鈕外多包一層容器就會失效,改用 btn.closest('tr') 會更健壯。