編輯型表格的行數往往事先無法確定。若一次給定過多空白列,頁面冗長、加載變慢;若完全不給,使用者每加一筆就得按一次新增。比較好的折衷是「保持底部有若干空白列,使用者一動就自動補上」。以下示範這個做法,並處理最麻煩的部分——新列的插件綁定。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>表格動態新增列</title>
<link href="../Script/jquery-easyui-1.3.2/themes/default/easyui.css" rel="stylesheet" />
<style>
.autoRows { width:350px; border:1px green solid; }
.autoRows tbody tr td { border-bottom:1px green solid; margin:0px; }
.autoRows thead { background-color:#8ec7d7; }
.autoRows tfoot { background-color:#8ec7d7; }
</style>
</head>
<body>
<table border="0" cellspacing="0" id="table1" class="autoRows">
<thead>
<tr><th>表頭1</th><th>表頭1</th><th>表頭1</th></tr>
<tr><th>表頭2</th><th>表頭2</th><th>表頭2</th></tr>
</thead>
<tbody>
<tr>
<td><input id="Button1" type="button" value="insertAfter"
onclick="addrow(this);" /></td>
<td><input id="Button3" type="button" value="Clear"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, false);" /></td>
<td><input id="Text2" type="text" value="aaaa" /></td>
</tr>
<tr>
<td><input id="Button2" type="button" value="insertBefore"
onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
<td><input id="Button4" type="button" value="Reset"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
<td><input id="Text1" name="ttt" type="text" value="asdfasfasfdsd" /></td>
</tr>
<tr>
<td><input id="Button5" type="button" value="insertBefore"
onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
<td><input id="Button6" type="button" value="Reset"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
<td><input id="Text3" name="Text3" type="text" /></td>
</tr>
</tbody>
<tfoot>
<tr><th>表尾1</th><th>表尾2</th><th>表尾3</th></tr>
</tfoot>
</table>
<div style="height:20px;"></div>
<table border="0" cellspacing="0" id="table2" class="autoRows">
<thead>
<tr><th>表頭1</th><th>表頭1</th><th>表頭1</th></tr>
<tr><th>表頭2</th><th>表頭2</th><th>表頭2</th></tr>
</thead>
<tbody>
<tr>
<td><input id="Button7" type="button" value="insertAfter"
onclick="addrow(this);" /></td>
<td><input id="Button8" type="button" value="Clear"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, false);" /></td>
<td><input id="Text4" type="text" value="aaaa" /></td>
</tr>
<tr>
<td><input id="Button9" type="button" value="insertBefore"
onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
<td><input id="Button10" type="button" value="Reset"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
<td><input id="Text5" name="ttt" type="text" value="asdfasfasfdsd" /></td>
</tr>
<tr>
<td><input id="Button11" type="button" value="insertBefore"
onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
<td><input id="Button12" type="button" value="Reset"
onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
<td><input id="Text6" name="Text3" type="text" /></td>
</tr>
</tbody>
<tfoot>
<tr><th>表尾1</th><th>表尾2</th><th>表尾3</th></tr>
</tfoot>
</table>
</body>
</html>
掛載與初始化:
<script src="../Script/jquery-1.7.2.min.js"></script>
<script src="../Script/jquery.tableAutoRow.js"></script>
<script src="../Script/jquery.timepicker.js"></script>
<script type="text/javascript">
$(function () {
$(".autoRows").tableAutoRow(aaa);
// 這是「為新列綁定插件」的關鍵回呼
function aaa(row) {
$(row).find(':text').timepicker();
}
});
function addrow(obj) {
$.fn.tableAutoRow.insertRow(obj);
}
</script>
插件主體:
(function ($) {
$.fn.extend({
rowfunction: null,
tableAutoRow: function (newRowFunction) {
rowfunction = newRowFunction;
return $(this).each(function () {
var tb = this;
if (!(this.tagName.toUpperCase() == "TBODY")) {
if (!this.tBodies[0]) { return; }
tb = this.tBodies[0];
}
// 加入一個隱藏列作為後續複製的模板
var lastRow = tb.rows[tb.rows.length - 1];
var row = $(lastRow).clone(true, true);
$(row).insertAfter($(tb).find("tr:last")).hide();
// 為現有列加上自動補列事件
for (var i = 0; i < tb.rows.length; i++) {
AddAutoRowsEvent(tb.rows[i]);
}
});
}
});
// 自動增加列
function autoRows(e) {
var e = e || event;
var obj = e.target || e.srcElement;
while (obj.tagName != "TR") { obj = obj.parentNode; }
var tb = obj.parentNode;
var index = $(obj).index();
var n = 5 - (tb.rows.length - index);
if (n > 0) {
var lastRow = tb.rows[tb.rows.length - 1];
for (var j = 0; j < n; j++) {
var row = $(lastRow).clone(true, true);
row.insertBefore($(tb).find("tr:last")).show();
// 若有回呼函式則執行(重新綁定插件)
if (typeof (rowfunction) == 'function') {
rowfunction(row);
}
}
}
}
// 為指定列加上事件
function AddAutoRowsEvent(tr) {
if (tr instanceof jQuery) { tr = tr[0]; }
$(tr).bind('click', autoRows);
var c = tr.cells.length;
for (var j = 0; j < c; j++) {
var childs = tr.cells[j].childNodes;
for (var k = 0; k < childs.length; k++) {
if (childs[k].type == "text"
|| childs[k].type == "textarea"
|| childs[k].type == "button") {
$(childs[k]).bind('focus', autoRows);
}
}
}
}
// 在指定位置插入 n 列
$.fn.tableAutoRow.insertRow = function (obj, n, bAutoRows, isInsertAfter) {
var loop = 0;
while (obj.tagName != "TR" && loop < 10) {
obj = obj.parentNode;
loop++;
}
if (obj.tagName != "TR") { return; }
var tb = obj.parentNode;
switch (arguments.length) {
case 3: var isInsertAfter = true;
case 2: var bAutoRows = true; var isInsertAfter = true;
case 1: var bAutoRows = true; var isInsertAfter = true; var n = 1;
}
for (var i = 0; i < n; i++) {
var lastRow = tb.rows[tb.rows.length - 1];
var row = $(lastRow).clone(true, true);
if (isInsertAfter) { row.insertAfter(obj).show(); }
else { row.insertBefore(obj).show(); }
if (bAutoRows) { AddAutoRowsEvent(row); }
}
};
// 清除指定範圍內的資料
$.fn.tableAutoRow.clearRowData = function (obj, startColnum, endColumn, isReset) {
var loop = 0;
while (obj.tagName != "TR" && loop < 10) {
obj = obj.parentNode;
loop++;
}
if (obj.tagName != "TR") { return; }
var cellsCount = obj.cells.length;
if (startColnum < 0 || !startColnum) { startColnum = 0; }
if (endColumn > cellsCount - 1 || !endColumn) { endColumn = cellsCount - 1; }
if (isReset == undefined) { isReset = false; }
for (var c = startColnum; c <= endColumn; c++) {
for (var j = 0; j < obj.cells[c].childNodes.length; j++) {
setObjData(obj.cells[c].childNodes[j], isReset);
}
}
};
function setObjData(node, isReset) {
switch (node.type) {
case "text":
case "hidden":
case "textarea":
node.value = isReset ? node.defaultValue : "";
break;
case "select-one":
case "select-multiple":
for (var k = node.options.length - 1; k >= 0; k--) {
node.options[k].selected = isReset
? node.options[k].defaultSelected
: false;
}
break;
case "checkbox":
case "radio":
node.checked = isReset ? node.defaultChecked : false;
break;
}
// 遞迴處理巢狀節點
if (node.childNodes && node.childNodes.length > 0) {
var l = node.childNodes.length;
for (var i = 0; i < l; i++) {
setObjData(node.childNodes[i], isReset);
}
}
}
})(jQuery);
用 defaultValue 實作 Reset。這個插件區分了「Clear」與「Reset」:Clear 一律清空,Reset 則還原到 defaultValue、defaultSelected、defaultChecked——也就是 HTML 上原本寫的值。這是原生 DOM 提供的屬性,用起來比自己做一份初始狀態快照優雅得多。
用隱藏列做複製模板。初始化時先複製最後一列並隱藏,之後新增時 clone 它。這確保新列與原列的結構完全一致,包括所有 class、name 與巢狀結構。
層級上溯時加上 loop 上限。while (obj.tagName != "TR" && loop < 10) 這個防護很重要——若傳入的物件不在任何 TR 內,沒有上限的 while 會一路走到 document 之後變成無窮迴圈,把瀏覽器凍結。
clone(true, true) 會複製事件綁定,但不會複製插件產生的 DOM。timepicker 若在 input 旁插入了圖示或容器,那些是插件自己建立的節點,不在 clone 範圍內。這正是需要 rowfunction 回呼重新初始化的原因。任何靠 JS 改造 DOM 的插件(日期選擇器、驗證提示、標籤輸入框)都會遇到同樣問題,重新初始化是唯一可靠的解法。switch 的 case 遞落寫法有 bug。case 3 只設 isInsertAfter 就落穿,但沒設 n 與 bAutoRows,導致傳三個參數時 n 為 undefined、迴圈根本不會執行。正確做法是用預設值:n = n || 1; bAutoRows = bAutoRows !== false;。name 屬性,後端收到多個同名欄位時的處理方式取決於框架,容易出錯。實務上應在複製後重新編號:$(row).find("[name]").each(function(){ this.name = this.name.replace(/\[\d+\]/, "[" + idx + "]"); })。最後,這個插件依賴 .bind() 與全域變數 rowfunction(多個表格實例會互相覆蓋)。若重寫,改用 .on() 並把回呼存進每個元素的 jQuery data 中,會更穩健。