在表單型的後台頁面裡,「多行明細」是非常常見的需求:使用者可以隨時新增一列、填完再按儲存、不要的直接刪掉。這類功能的關鍵在於如何精準地從被點擊的那一列中取值,而不是取到整份表單。本文以一個報修/租借明細表為例,示範如何用 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 內含特殊字元時語法破碎。
刪除的邏輯非常直觀——找到該列然後 remove()。由於資料都還在前端,尚未送出,直接從 DOM 移除即可,不需要呼叫後端。
function DelItem(index) {
// 若該列已有 innerid,代表已存在於後端,此處可改為呼叫刪除 API
$("tr[id=" + index + "]").remove();
}
新增列最簡便的方式是複製最後一列再清空輸入值,但更乾淨的做法是把列的 HTML 存成 jQuery 物件或 <template>,用時複製並重新編號。三個實務提醒:
一是請改用 class 作為控件選擇依據。同一列內的控件用 class 標記,跨列操作才不會互相干擾。
二是屬性選擇器效能。在列數很多時,[ID$=...] 這類模糊比對會比 .find(".className") 慢,能精確就精確。
三是欄位驗證要走在送出之前。像範例中對專案編號的檢查那樣,把必填與格式驗證放在呼叫 API 之前,可以省下大量來回請求,也能給使用者更快的回饋。