jquery.val
jQuery .val() 方法详解
jQuery 的 .val() 方法是用于获取或设置表单元素值的核心方法,支持输入框、下拉框、单选按钮等多种表单元素。以下是具体用法和示例:
获取表单元素的值
调用无参数的 .val() 会返回匹配的第一个元素的值:
// 获取输入框的值
const username = $('#username').val();
// 获取单选按钮的值(需选中状态)
const gender = $('input[name="gender"]:checked').val();
// 获取下拉框选中项的值
const country = $('#country').val();
设置表单元素的值
传递参数会设置所有匹配元素的值:
// 设置输入框的值
$('#username').val('默认用户');
// 设置单选按钮/复选框的选中状态
$('input[name="subscribe"]').val(['yes']); // 勾选值为"yes"的选项
// 设置下拉框选中项
$('#country').val('CN'); // 选中value="CN"的选项
特殊表单元素处理
多选下拉框:返回数组形式的值
// 获取所有选中的选项值(数组)
const selected = $('#multi-select').val();
// 设置多个选中项
$('#multi-select').val(['opt1', 'opt3']);
文本域(textarea):与输入框用法一致
// 获取/设置文本内容
const content = $('#comment').val();
$('#comment').val('请输入内容');
链式调用示例
.val() 可与其他 jQuery 方法链式组合:

// 清空输入框并聚焦
$('#search')
.val('')
.focus();
注意事项
- 对普通非表单元素(如
div、span)使用.val()会返回undefined。 - 设置下拉框时若值不存在,则不会选中任何选项。
- jQuery 3.0+ 版本中,
.val()对隐藏元素返回空字符串(早期版本可能返回undefined)。






