可編輯的資料表格往往是後台系統最難寫的部分:要驗證使用者輸入、要能新增刪除列、要即時統計彙總、要有計算欄位(例如總價 = 單價 × 數量),最後還得把資料正確送到後端存進資料庫。本文的 dynamicTable 外掛試圖把這些瑣事一次處理掉。
class="rownum";需要唯一編號的屬性(如 radio 的 name、id)以 {0} 作佔位符,外掛會自動填入流水號;不該被使用者刪除的固定列(如統計列)要標 fixed="true";需要回傳值的輸入元件或 label 則標 property="propertyname"。last(最後)。也支援 first,或數值——正數從第一列起算,負數從最後一列往前算。之所以需要這麼多選項,是因為表格最後常是彙總列等固定列,不能任意插入。selector(觸發按鈕的選擇器)與 handler(刪除策略:first 刪除第一列、last 刪除最後一列、current 刪除當前列)。所有刪除操作都會跳過 fixed="true" 的列。selector(顯示結果的控件選擇器)、column(要彙總的 property 名稱)、func(運算方式)。內建支援 sum/max/min/count/avg,也可自訂函式,傳入參數為該列的 property 值陣列。trigger(觸發重算的 property 陣列)、column(計算結果要寫入的 property)、func(自訂運算函式)。適合用來處理「商品總價 = 單價 × 數量」這類需求,也能兼作驗證的觸發器。$(selector).updateSortNum():更新所有帶 rownum class 的 td 的序號。$(rowSelector).getRowObj():取得以 property 為索引的單列 JavaScript 物件。$(tableSelector).getTableObj():取得整個表格的物件陣列,每個元素是一列。getSource(saveHiddentField):取得以 XML 組織的屬性集。可傳入 item(每列資料的 XML 節點名稱,預設 item)與 root(根節點名稱,預設 root);若傳入 saveHiddentField 選擇器,會自動把 XML 賦值到該隱藏欄位。有了 XML,後端就能直接解析,或用 DataSet.ReadXml() 轉成 DataTable。$(inputSelector).getValue():取得控件值,支援 text、label、checkbox、radio、td、textarea。其中 radio 取選中項的 value,checkbox 則取所有勾選項的 value 並以逗號串接。至於驗證,外掛刻意不內建型別驗證——因為驗證需求變化太多,而且市面上已有許多優秀的 jQuery 驗證外掛可搭配使用。作者的做法是自己寫幾個簡單的規則:
// 日期欄:點入時叫出日期選擇器
$(".datetime").live("focus", function() {
WdatePicker({ readOnly: true, dateFmt: 'yyyy年MM月dd日' }); // MyDate97
});
// 數字欄:只允許數字、小數點與負號;按 - 鍵則變號
$(".number").live("keyup", function() {
this.value = this.value.replace(/[^-\d\.]/g, '');
}).live("keydown", function(e) {
if (e.which == 189) {
$(this).val(-1 * parseFloat($(this).val())).trigger("change");
e.stopPropagation();
e.preventDefault();
}
});
外掛要求 table 遵循 W3C 標準,必須有 thead 與 tbody。表頭想多複雜都可以,多層表頭也沒問題。
<script type="text/javascript">
function m(v) { return v[0] + 100; }
$(function() {
$("table").dynamicTable({
addTrigger: ".add",
removeTrigger: [
{ selector: ".delete", handler: "first" },
{ selector: ".deleterow", handler: "current" }
],
rowTemplate:
"<tr><td class='rownum' property='sortnum'></td>" +
"<td><input type='text' property='name'/></td>" +
"<td><input type='text' property='age' class='number'/></td>" +
"<td>" +
"<input type='radio' property='Sex' value='1' name='test{0}' style='width:10px'/>nan<br/>" +
"<input type='radio' value='0' name='test{0}' style='width:10px'/>nv" +
"</td>" +
"<td><input type='text' property='email'/></td>" +
"<td><input type='text' property='phone'/></td>" +
"<td><input type='text' property='date' class='datetime'/></td>" +
"<td>" +
"<input property='checkbox' type='checkbox' value='1' style='width:10px'/>test1" +
"<input type='checkbox' value='2' style='width:10px'/>test2" +
"</td>" +
"<td style='text-align:center;'>" +
"<a class='deleterow' style='cursor:hand;'>" +
"<img alt='刪除' src='Image/delete.png' " +
"style='border:0px; width:16px; height:16px' />刪除</a>" +
"</td></tr>",
addPosition: -1, // 插到倒數第一列之前,避開彙總列
Calculates: [
{ selector: "#totalage", column: "age", func: "sum" }
],
CalculatesColumn: [
{ trigger: ["age", "name"], column: "date",
func: function(o, rowobj) {
o.value = parseFloat(rowobj.age) + parseFloat(rowobj.name);
} }
]
});
});
</script>
表格本體:
<table style="width:100%;" border="1" cellpadding="0" cellspacing="0" class="TableStyle">
<thead>
<tr style="text-align:center;">
<td rowspan="2">序號</td>
<td rowspan="2">姓名</td>
<td rowspan="2">年齡</td>
<td rowspan="2">Sex</td>
<td colspan="2">聯系信息</td>
<td rowspan="2">日期</td>
<td rowspan="2">test checkbox</td>
<td rowspan="2">
<a class="add"><img alt="增加" src="Image/add.png"
style="border:0px; width:16px; height:16px" />增加</a>
<a class="delete" style="cursor:hand;"><img alt="刪除" src="Image/delete.png"
style="border:0px; width:16px; height:16px" />刪除</a>
</td>
</tr>
<tr>
<td>Email</td>
<td>電話</td>
</tr>
</thead>
<tbody>
<tr fixed="true"><td colspan="9"></td></tr>
</tbody>
</table>
<input type="text" id="totalage" />
<input type="button" value="getSource" onclick="alert($('table').getSource());" />
<input type="button" value="getObject" />
<div id="resultdiv"></div>
<script type="text/javascript">
$("input:[value='getObject']").live("click", function() {
var obj = $("table").getTableObj();
$("#resultdiv").html("");
for (var i = 0; i < obj.length; i++) {
for (var o in obj[i]) {
$("#resultdiv").html($("#resultdiv").html() + " " + o + "->" + obj[i][o]);
}
$("#resultdiv").html($("#resultdiv").html() + "<br/>");
}
});
</script>
實際執行後的畫面:


作者坦言測試程式碼寫得比較隨意,沒有考慮實際業務性質——例如把標題「日期」當成計算欄位、把年齡當成統計欄,純粹為了示範功能,並在後端的 input 做彙總。他歡迎大家回報 bug,也感謝一路上的交流指正。
這個外掛最有價值的部分,是它把「表格即資料結構」的概念落實了:透過 property 標記欄位語意,再用 getTableObj() 一口氣轉成 JavaScript 物件陣列,或是以 getSource() 輸出 XML 交給後端。相比逐一 $("#txt1").val() 取值,這種做法在欄位眾多時維護性明顯更好。
若要在今日重新實作,有幾點值得調整:live() 應改為 on();以 fixed="true" 這種自訂屬性標記,較建議改用 data-fixed="true" 以符合 HTML5 規範;而整份程式碼若搭配前端框架的響應式資料模型,多數手動 DOM 操作都可以省下來。
作者:破 浪