jQuery .val() 是處理表單元素值的統一介面,支援 <input>、<select>、<textarea>、單選/複選框等所有表單控制項。統一 API 避免了原生 JS 需區分 .value、.checked、.selectedIndex 的麻煩。
// 文字輸入框
var textVal = $("input#mytextbox").val();
// 下拉選單(取得選中 option 的 value)
var selectVal = $("select#mylist").val();
// 單選按鈕(取得同 name 群組中被選中的 value)
var radioVal = $("input[name='myradio']:checked").val();
// 複選框(取得第一個被勾選的 value,通常配合 map() 取所有)
var checkboxVal = $("input[name='mycheck']:checked").val();
// 多選下拉選單(回傳陣列)
var multiSelectVal = $("select[multiple]").val(); // ["val1", "val2"]
// 文字輸入框
$("input#mytextbox").val("新內容");
// 下拉選單(依 value 選中對應 option)
$("select#mylist").val("第一列");
// 單選按鈕(依 value 選中對應 radio)
$("input[name='myradio']").val("2"); // 會自動勾選 value="2" 的那個
// 複選框(需傳陣列,一次勾選多個)
$("input[name='mycheck']").val(["val1", "val3"]);
// 多選下拉選單
$("select[multiple]").val(["opt1", "opt3"]);
// 獲取所有勾選值(陣列)
var checkedValues = $("input[name='fruit']:checked").map(function() {
return this.value;
}).get();
// 設置多選框(傳入陣列)
$("input[name='fruit']").val(["apple", "banana"]);
.val() 設置值不會自動觸發 change 事件。若有綁定 change 監聽器,需手動觸發:
$("select#mylist").val("新值").trigger("change");
// 單一元素,原生更快
var val = document.getElementById("mytextbox").value;
// 批量操作時 jQuery 更方便
$("input:text").val(function(index, oldVal) {
return oldVal.trim().toUpperCase();
});
// 唯讀輸入框可讀可寫
$("input[readonly]").val("新值"); // 可寫入
// 禁用元素可讀,但表單提交時不會發送
$("input[disabled]").val("新值"); // 可寫入,但不會隨表單提交
$.fn.serializeObject = function() {
var obj = {};
$.each(this.serializeArray(), function(i, item) {
if (obj[item.name] !== undefined) {
if (!$.isArray(obj[item.name])) obj[item.name] = [obj[item.name]];
obj[item.name].push(item.value);
} else {
obj[item.name] = item.value;
}
});
return obj;
};
// 使用
var formData = $("#myForm").serializeObject();
// { name: "張三", age: "25", hobby: ["reading", "swimming"] }
$.fn.populateForm = function(data) {
return this.each(function() {
var $form = $(this);
$.each(data, function(name, value) {
var $field = $form.find("[name='" + name + "']");
if ($field.length) {
if ($field.is(":radio")) {
$field.filter("[value='" + value + "']").prop("checked", true);
} else if ($field.is(":checkbox")) {
var vals = $.isArray(value) ? value : [value];
$field.each(function() {
this.checked = $.inArray($(this).val(), vals) >= 0;
});
} else {
$field.val(value);
}
}
});
});
};
// 使用
$("#myForm").populateForm({
name: "李四",
gender: "female",
skills: ["js", "css"]
});
| 方法 | 適用場景 | 備註 |
|---|---|---|
| .val() | 表單元素目前值 | 使用者輸入後的即時值 |
| .prop('checked') | checkbox/radio 勾選狀態 | 布林值,jQuery 1.6+ 推薦 |
| .attr('value') | input 初始 value 屬性 | 不會反映使用者輸入變化 |
| .prop('selectedIndex') | select 選中索引 | 單選下拉適用 |
| .prop('selected', true) | 設定 option 選中 | 需針對 option 元素操作 |
.val() 是 jQuery 表單操作的瑞士刀。記住三個核心原則:
搭配 .serialize()、.serializeArray()、自訂 serializeObject()/populateForm(),即可構建完整的表單資料流管理解決方案。