val() 核心功能速查
| 呼叫形式 | 用途 | 返回值 | 適用元素 |
.val() | 讀取值 | 字串 / 陣列 / null | input, select, textarea |
.val(value) | 設置值 | jQuery 物件 (鏈式) | input, select, textarea |
.val(function) | 函數設置值 | jQuery 物件 | input, select, textarea |
完整互動範例
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery val() 方法示範</title>
<style>
.container { max-width: 600px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
.form-group { margin: 16px 0; display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
label { min-width: 100px; font-weight: 500; }
input, select, textarea { flex: 1; min-width: 200px; padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; font-size: 14px; }
textarea { min-height: 80px; resize: vertical; }
.controls { display: flex; gap: 10px; flex-wrap: wrap; margin: 20px 0; }
button { padding: 10px 20px; background: #1976d2; color: white; border: none; border-radius: 6px; cursor: pointer; }
button.secondary { background: #757575; }
button.success { background: #4caf50; }
.result { background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; white-space: pre-wrap; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div class="container">
<h2>jQuery val() 綜合示範</h2>
<div class="form-group">
<label>單行文字:</label>
<input type="text" id="txtName" value="初始文字">
</div>
<div class="form-group">
<label>數字輸入:</label>
<input type="number" id="txtAge" value="25">
</div>
<div class="form-group">
<label>下拉單選:</label>
<select id="selCity">
<option value="bj">北京</option>
<option value="sh" selected>上海</option>
<option value="gz">廣州</option>
<option value="sz">深圳</option>
</select>
</div>
<div class="form-group">
<label>下拉多選:</label>
<select id="selMulti" multiple size="4">
<option value="js">JavaScript</option>
<option value="ts" selected>TypeScript</option>
<option value="vue" selected>Vue</option>
<option value="react">React</option>
</select>
</div>
<div class="form-group">
<label>多行文字:</label>
<textarea id="txtDesc">初始描述內容</textarea>
</div>
<div class="form-group">
<label>核取方塊:</label>
<div>
<label><input type="checkbox" name="skill" value="html" checked> HTML</label>
<label><input type="checkbox" name="skill" value="css"> CSS</label>
<label><input type="checkbox" name="skill" value="js" checked> JavaScript</label>
</div>
</div>
<div class="form-group">
<label>單選按鈕:</label>
<div>
<label><input type="radio" name="gender" value="male" checked> 男</label>
<label><input type="radio" name="gender" value="female"> 女</label>
</div>
</div>
<div class="controls">
<button id="btnGetAll">獲取所有值</button>
<button id="btnSetAll" class="success">批量設置值</button>
<button id="btnFuncSet" class="secondary">函數動態設置</button>
<button id="btnClear" class="secondary">清空表單</button>
</div>
<div class="result" id="result">點擊按鈕查看結果</div>
</div>
<script>
$(function() {
const $result = $('#result');
const log = (msg) => $result.text(msg);
// 1. 獲取所有表單值
$('#btnGetAll').on('click', () => {
const data = {
name: $('#txtName').val(),
age: $('#txtAge').val(),
city: $('#selCity').val(),
skills: $('#multiSel').val(), // 多選返回陣列
desc: $('#txtDesc').val(),
gender: $('input[name="gender"]:checked').val() // 單選需用 :checked
};
log(JSON.stringify(data, null, 2));
});
// 2. 批量設置值
$('#btnSetAll').on('click', () => {
$('#txtName').val('張三');
$('#txtAge').val(30);
$('#selCity').val('gz');
$('#selMulti').val(['js', 'vue', 'react']); // 多選傳陣列
$('#txtDesc').val('這是通過 val() 批量設置的內容');
$('input[name="skill"]').val(['html', 'js']); // 核取方塊傳陣列
$('input[name="gender"]').val(['female']); // 單選也可用陣列
log('已批量設置所有表單值');
});
// 3. 函數動態設置 (根據索引/當前值計算)
$('#btnFuncSet').on('click', () => {
$('input[type="text"], textarea').val(function(i, oldVal) {
return `第 ${i+1} 個輸入框 - 原值: ${oldVal}`;
});
log('已使用函數動態設置文字類輸入框');
});
// 4. 清空表單
$('#btnClear').on('click', () => {
$('input, select, textarea').val(''); // 多選需傳空陣列 []
$('input[type="checkbox"], input[type="radio"]').prop('checked', false);
log('表單已清空');
});
});
</script>
</body>
</html>
關鍵細節深度解析
1. 不同元素類型的 val() 行為差異
| 元素類型 | .val() 返回 | .val(value) 設置 |
<input type="text/password/email/number...> | 字串 | 字串/數值 → 字串 |
<textarea> | 字串 (含換行) | 字串 |
<select> (單選) | 字串 (選中 option 的 value) | 字串 → 選中對應 value 的 option |
<select multiple> | 陣列 (所有選中 option 的 value) | 陣列 → 選中所有匹配 value 的 option |
<input type="checkbox"> | 字串 (第一個被勾選的 value) ⚠️ | 陣列 → 勾選所有匹配 value |
<input type="radio"> | 字串 (被勾選的 value) | 陣列/字串 → 勾選匹配 value |
2. 核取方塊群組取值:不要用 .val()
// ❌ 錯誤:只返回第一個勾選的值
$('input[name="skill"]').val(); // "html"
// ✅ 正確:用 map 獲取所有勾選值
const skills = $('input[name="skill"]:checked').map((_, el) => el.value).get(); // ["html", "js"]
3. .val([]) 清空多選 / 核取方塊群組
// 清空多選下拉框
$('#selMulti').val([]);
// 清空核取方塊群組
$('input[name="skill"]').val([]); // jQuery 3.0+ 支援
// 或
$('input[name="skill"]').prop('checked', false); // 通用做法
4. 函數參數:(index, currentValue) => newValue
// 為所有輸入框添加前綴
$('input[type="text"]').val((i, val) => `項目${i+1}: ${val}`);
// 將所有數字輸入框數值乘 2
$('input[type="number"]').val((i, val) => parseFloat(val) * 2 || 0);
實戰模式:表單資料雙向綁定
class FormBinder {
constructor(formSelector) {
this.$form = $(formSelector);
this.bindInputs();
}
bindInputs() {
this.$form.on('input change', 'input, select, textarea', (e) => {
const $el = $(e.target);
const name = $el.attr('name');
if (name) this.data[name] = this.getValue($el);
});
}
getValue($el) {
if ($el.is('select[multiple]')) return $el.val() || [];
if ($el.is('input[type="checkbox"]')) {
return $('input[name="' + $el.attr('name') + '"]:checked').map((_,e)=>e.value).get();
}
return $el.val();
}
setData(data) {
this.data = data;
Object.entries(data).forEach(([name, value]) => {
const $el = this.$form.find(`[name="${name}"]`);
if ($el.is('select[multiple]') || $el.is('input[type="checkbox"]')) {
$el.val(Array.isArray(value) ? value : [value]);
} else {
$el.val(value);
}
});
}
getData() { return this.data; }
}
避坑指南
⚠ 常見錯誤:
$('#sel').val('not-exist'):不報錯但無效果,下拉框顯示空白/第一項
$('input[name="x"]').val() 取核取方塊群組值 → 只得第一個
- 動態新增
<option> 後直接 .val() 設置 → 需確保 option 已渲染到 DOM
.val(null) 在某些版本會報錯,清空請用 .val('') 或 .val([])
總結
val() 是 jQuery 表單操作的核心。掌握 單選返回字串、多選返回陣列、設置多選/核取方塊傳陣列、函數動態計算 這四大模式,加上 :checked 處理單選/核取方塊群組,即可應對所有表單取值設置場景。