DIV CSS 佈局教程網

jQuery 讀取 tr 內控件值並動態操作表格列的實作解析
編輯:JQuery特效代碼     

在表單型的後台頁面裡,「多行明細」是非常常見的需求:使用者可以隨時新增一列、填完再按儲存、不要的直接刪掉。這類功能的關鍵在於如何精準地從被點擊的那一列中取值,而不是取到整份表單。本文以一個報修/租借明細表為例,示範如何用 jQuery 定位 tr、抓取列內各控件的值,並完成新增與刪除。

表格結構設計

整張表可以拆成三個區塊:報修基本資料列、表頭列,以及承載明細資料的 <tbody id="tbItem">。明細列的每一行都有一個唯一的 id(例如 tbItem1),並在列尾放一組「儲存/刪除」連結與一個隱藏欄位 txtInnerID 用來記錄後台主鍵。

<table style="width: 100%; height: 100%" border="1">
<caption>Material/Special Tool Rental/Tool Cantainer/Transportation/Mobile</caption>
<tbody>
  <tr>
    <td>Project No</td>
    <td>
      <input type="hidden" name="hidProjectInnerID" id="hidProjectInnerID">
      <input name="txtProjectNo" type="text" id="txtProjectNo" class="Error">
      <a href="javascript:void(0)" onclick="SelectProject();">選擇</a>
    </td>
    <td>Final Custome:</td>
    <td><span id="labFinalCustome">Label</span></td>
    <td>Order No.</td>
    <td><span id="labOrderNo">Label</span></td>
    <td>Project Leaing Time:</td>
    <td><span id="labProjectLeaingTime">Label</span></td>
  </tr>
  <tr><td colspan="8">Exchange Rate:8.3000</td></tr>
  <tr align="center">
    <td>item</td>
    <td colspan="2">Description</td>
    <td>QTY</td>
    <td>Unit</td>
    <td>Total</td>
    <td>Remark</td>
    <td><a id="NewItem" href="javascript:void(0)">NewItem</a></td>
  </tr>
</tbody>
<tbody id="tbItem">
  <tr id="tbItem1" align="center">
    <td>
      <select id="selItem" name="Item">
        <option value="Material">Material</option>
        <option value="Mobile">Mobile</option>
        <option value="Others">Others</option>
        <option value="SpecialToolRental">Special Tool Rental</option>
        <option value="ToolContainer">Tool Container</option>
        <option value="Transportation">Transportation</option>
        <option value="WorkingHours">WorkingHours</option>
      </select>
    </td>
    <td colspan="2"><input id="txtDescription" style="width:90%" type="text" name="Item"></td>
    <td><input id="txtQTY" type="text" name="Item"></td>
    <td><input id="txtUnit" type="text" name="Item"></td>
    <td><input id="txtTotal" type="text" name="Item"></td>
    <td><input id="txtRemark" type="text" name="Item"></td>
    <td>
      <a href="javascript:;SaveItem('tbItem1')">保存</a> |
      <a href="javascript:;DelItem('tbItem1')">刪除</a>
      <input id="txtInnerID" type="hidden" name="Item">
    </td>
  </tr>
</tbody>
</table>

這裡有個實務上的坑:如果每一列都用相同的 id(例如全部都叫 txtQTY),HTML 就違反了 id 唯一性的規則,後續用 jQuery 選取時行為會變得不可預期。比較穩妥的做法是改用 class 選取,或在複製列時自動為 id 加上序號後綴。

儲存:從被點擊的列中取值

寫法的重點是「先定位 tr,再在 tr 的範圍內尋找控件」。tr.find() 會把搜尋範圍鎖定在該列,這樣不論頁面上有多少列,取到的永遠是當前這一列的資料。

function SaveItem(index) {
  var tr = $("tr[id=" + index + "]");

  // 在該列範圍內逐一取出各控件的值
  var innerid = tr.find('input[ID$=txtInnerID]').val();
  var item    = tr.find("select[id*=selItem]").val();
  var des     = tr.find('input[ID$=txtDescription]').val();
  var qty     = tr.find('input[ID$=txtQTY]').val();
  var unit    = tr.find('input[ID$=txtUnit]').val();
  var total   = tr.find('input[ID$=txtTotal]').val();
  var remark  = tr.find('input[ID$=txtRemark]').val();

  // 驗證專案編號是否已選擇
  var proinnerid = $("#hidProjectInnerID").val();
  if (proinnerid == "") {
    $("#txtProjectNo").removeClass("Field");
    $("#txtProjectNo").addClass("Error");
    return false;
  }

  // 送出至後端儲存(依實際 API 調整)
  jQuery.ajax({
    type: 'get',
    url: '../Handler/ProjectReport.ashx',
    data: {
      "key": "save",
      "proinnerid": proinnerid,
      "innerid": innerid,
      "item": item,
      "content": des,
      "qty": qty,
      "unit": unit,
      "total": total,
      "remark": remark
    },
    cache: false,
    success: function (result) {
      var jsonobj = eval(result);
      if (jsonobj[0].result == "true") alert("儲存成功");
      else alert("儲存失敗");
    }
  });
}

這裡用到的兩個屬性選擇器值得記住:[ID$=txtQTY] 是「以 txtQTY 結尾」,[id*=selItem] 是「包含 selItem」。在 ASP.NET WebForms 環境下,伺服器控件實際輸出的 id 常會被加上前綴(如 ctl00_ContentPlaceHolder1_txtQTY),用「包含」或「結尾」比對就比精確等號来得可靠。另外,原本的寫法在屬性值中直接夾入變數,需注意引號的成對問題,實務上建議寫成 $("tr[id='" + index + "']"),用單引號包住屬性值,可避免 ID 內含特殊字元時語法破碎。

刪除:直接移除整個 tr

刪除的邏輯非常直觀——找到該列然後 remove()。由於資料都還在前端,尚未送出,直接從 DOM 移除即可,不需要呼叫後端。

function DelItem(index) {
  // 若該列已有 innerid,代表已存在於後端,此處可改為呼叫刪除 API
  $("tr[id=" + index + "]").remove();
}

新增一列的做法與幾點提醒

新增列最簡便的方式是複製最後一列再清空輸入值,但更乾淨的做法是把列的 HTML 存成 jQuery 物件或 <template>,用時複製並重新編號。三個實務提醒:

一是請改用 class 作為控件選擇依據。同一列內的控件用 class 標記,跨列操作才不會互相干擾。

二是屬性選擇器效能。在列數很多時,[ID$=...] 這類模糊比對會比 .find(".className") 慢,能精確就精確。

三是欄位驗證要走在送出之前。像範例中對專案編號的檢查那樣,把必填與格式驗證放在呼叫 API 之前,可以省下大量來回請求,也能給使用者更快的回饋。

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