DIV CSS 佈局教程網

jQuery 動態表格外掛:新增刪除、統計彙總與計算欄位
編輯:JQuery特效代碼     

可編輯的資料表格往往是後台系統最難寫的部分:要驗證使用者輸入、要能新增刪除列、要即時統計彙總、要有計算欄位(例如總價 = 單價 × 數量),最後還得把資料正確送到後端存進資料庫。本文的 dynamicTable 外掛試圖把這些瑣事一次處理掉。

外掛屬性說明

  • rowTemplate:插入列的 HTML 模板。模板中,序號欄需標記 class="rownum";需要唯一編號的屬性(如 radio 的 name、id)以 {0} 作佔位符,外掛會自動填入流水號;不該被使用者刪除的固定列(如統計列)要標 fixed="true";需要回傳值的輸入元件或 label 則標 property="propertyname"。
  • addTrigger:觸發新增列的 jQuery 選擇器。
  • addPosition:插入位置,預設 last(最後)。也支援 first,或數值——正數從第一列起算,負數從最後一列往前算。之所以需要這麼多選項,是因為表格最後常是彙總列等固定列,不能任意插入。
  • removeTrigger:刪除按鈕的設定,是一個陣列,可有多組。每組包含 selector(觸發按鈕的選擇器)與 handler(刪除策略:first 刪除第一列、last 刪除最後一列、current 刪除當前列)。所有刪除操作都會跳過 fixed="true" 的列。
  • Calculates:彙總計算的設定陣列,每組含 selector(顯示結果的控件選擇器)、column(要彙總的 property 名稱)、func(運算方式)。內建支援 sum/max/min/count/avg,也可自訂函式,傳入參數為該列的 property 值陣列。
  • CalculatesColumn:計算欄位的設定陣列,每組含 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 操作都可以省下來。

作者:破 浪

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved