jQuery 獲取控件值看似簡單,實則有 DOM 屬性、jQuery 方法、屬性操作三類 API,且 ASP.NET 服務端控件 ID 渲染差異帶來特殊挑戰。本文系統梳理所有獲取/設置方式,建立統一認知標準。
ASP.NET WebForms 渲染時會重寫 ID(如 `ctl00_ContentPlaceHolder1_txtUserID`)。三種選擇器策略:
// 1. 內嵌代碼塊輸出 ClientID(最精確,需 .aspx 頁面內聯腳本)
$("#<%= txtUserID.ClientID %>").val();
// 2. 屬性結尾匹配(通用,性能稍弱)
$("input[id$='txtUserID']").val();
// 3. 屬性包含匹配(較寬鬆)
$("input[id*='txtUserID']").val();
// 推薦:給控件添加固定 CssClass
// JS 中
$(".js-user-id").val();
| 控件類型 | 獲取值 (推薦) | 設置值 (推薦) | 備選方案 |
|---|---|---|---|
| 文本框/文本域/隱藏域/密碼框 | `.val()` | `.val("新值")` | `[0].value` / `.attr("value")` |
| 單選框 | `$("input[name=sex]:checked").val()` | `$("input[name=sex][value=1]").prop("checked", true)` | 原生 `form.sex.value` |
| 多選框 | `$("input[name=hobby]:checked").map(...).get()` | `$("input[name=hobby][value=1]").prop("checked", true)` | FormData.getAll() |
| 下拉單選 | `.val()` | `.val("值")` | `[0].selectedIndex = 1` |
| 下拉多選 | `.val()` (返回數組) | `.val(["值1", "值2"])` | 遍歷 option 設置 selected |
| 按鈕/提交按鈕 | `.val()` | `.val("新文本")` | `.text("新文本")` (button 標籤) |
// 文本框
$("#txt").attr("value", "新值"); // 僅修改 HTML 屬性,界面不一定更新(視瀏覽器)
$("#txt").val("新值"); // 正確:修改 DOM property,界面即時更新
// Checkbox
$("#chk").attr("checked", true); // jQuery 1.6+ 僅設置屬性,不改變勾選狀態
$("#chk").prop("checked", true); // 正確:修改 DOM property
var val = $("#txt").value; // undefined!jQuery 對象無 value 屬性
var val = $("#txt")[0].value; // 正確:取原生 DOM
var val = $("#txt").val(); // 推薦:jQuery 方法
var params = $("#form").serialize();
// "username=張三&gender=1&hobby=2&hobby=3&city=bj"
var arr = $("#form").serializeArray();
// [{name:"username",value:"張三"}, {name:"gender",value:"1"}, ...]
function formToJson($form) {
var data = {};
$form.serializeArray().forEach(function(field) {
if (data[field.name]) {
data[field.name] = Array.isArray(data[field.name]) ? data[field.name] : [data[field.name]];
data[field.name].push(field.value);
} else {
data[field.name] = field.value;
}
});
return data;
}
// ASPX
北京
上海
// JS (內聯腳本)
var value = $("#<%= ddlCity.ClientID %> option:selected").val(); // "bj"
var text = $("#<%= ddlCity.ClientID %> option:selected").text(); // "北京"
// 設置選中
$("#<%= ddlCity.ClientID %>").val("sh");
// 輕量級表單工具(無依賴)
const FormUtil = {
getValues(form) {
const fd = new FormData(form);
const data = {};
for (let [k, v] of fd.entries()) {
data[k] = data[k] ? [].concat(data[k], v) : v;
}
return data;
},
setValues(form, data) {
for (let [k, v] of Object.entries(data)) {
const el = form.elements.namedItem(k);
if (!el) continue;
if (el.type === "select-multiple") {
[...el.options].forEach(o => o.selected = Array.isArray(v) ? v.includes(o.value) : o.value === v);
} else if (el.type === "radio") {
[...form.elements.namedItem(k)].forEach(r => r.checked = r.value === v);
} else if (el.type === "checkbox") {
el.checked = Array.isArray(v) ? v.includes(el.value) : (el.value === v || v === true);
} else {
el.value = v;
}
}
}
};
// 使用
const data = FormUtil.getValues(document.getElementById("myForm"));
FormUtil.setValues(document.getElementById("myForm"), {username: "李四", hobby: ["1", "3"]});
建立「DOM Property vs HTML Attribute vs jQuery Method」的清晰心智模型,是寫出無 Bug 表單交互代碼的前提。