.val()

类别: 属性 | 表单 | 操作 > 通用属性
获取匹配元素集中第一个元素的当前值，或设置所有匹配元素的值。

内容

.val()返回值: 字符串 或 数字 或 数组

描述: 获取匹配元素集中第一个元素的当前值。

  • 版本添加: 1.0.val()

    • 此方法不接受任何参数。

.val() 方法主要用于获取表单元素的值，例如 input、select 和 textarea。当在空集合上调用时，它返回 undefined。

当集合中的第一个元素是 select-multiple（即，一个设置了 multiple 属性的 select 元素）时，.val() 返回一个包含每个选中选项值的数组。从 jQuery 3.0 开始，如果没有任何选项被选中，它将返回一个空数组；在 jQuery 3.0 之前，它将返回 null。

对于选择框、复选框和单选按钮，可以使用 :checked 选择正确的元素。例如

1
2
3
4
5
6
7
8
9
10
11
 
// Get the value from the selected option in a dropdown
$( "select#foo option:checked" ).val();
 
// Get the value from a dropdown select directly
$( "select#foo" ).val();
 
// Get the value from a checked checkbox
$( "input[type=checkbox][name=bar]:checked" ).val();
 
// Get the value from a set of radio buttons
$( "input[type=radio][name=baz]:checked" ).val();

注意: 目前，在 <textarea> 元素上使用 .val() 会从浏览器报告的值中删除回车符。但是，当此值通过 XHR 发送到服务器时，回车符将被保留（或由不包含原始值的浏览器添加）。可以使用 valHook 解决此问题，如下所示

1
2
3
4
5
 
$.valHooks.textarea = {
  get: function( elem ) {
    return elem.value.replace( /\r?\n/g, "\r\n" );
  }
};

示例

从单个选择框中获取单个值，从多个选择框中获取值数组，并显示它们的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>val demo</title>
  <style>
  p {
    color: red;
    margin: 4px;
  }
  b {
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p></p>
 
<select id="single">
  <option>Single</option>
  <option>Single2</option>
</select>
 
<select id="multiple" multiple="multiple">
  <option selected="selected">Multiple</option>
  <option>Multiple2</option>
  <option selected="selected">Multiple3</option>
</select>
 
<script>
function displayVals() {
  var singleValues = $( "#single" ).val();
  var multipleValues = $( "#multiple" ).val() || [];
  // When using jQuery 3:
  // var multipleValues = $( "#multiple" ).val();
  $( "p" ).html( "<b>Single:</b> " + singleValues +
    " <b>Multiple:</b> " + multipleValues.join( ", " ) );
}
 
$( "select" ).on( "change", displayVals );
displayVals();
</script>
 
</body>
</html>

演示

查找输入框的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>val demo</title>
  <style>
  p {
    color: blue;
    margin: 8px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<input type="text" value="some text">
<p></p>
 
<script>
$( "input" )
  .on( "keyup", function() {
    var value = $( this ).val();
    $( "p" ).text( value );
  } )
  .trigger( "keyup" );
</script>
 
</body>
</html>

演示

.val( value )返回值: jQuery

描述: 设置匹配元素集中每个元素的值。

此方法通常用于设置表单字段的值。

val() 允许您传递一个元素值数组。这在处理包含 <input type="checkbox">、<input type="radio"> 和 <select> 中的 <option> 等元素的 jQuery 对象时很有用。在这种情况下，input 和 option 的 value 与数组中的一个元素匹配的将被选中或勾选，而 value 与数组中的一个元素不匹配的将被取消选中或取消勾选，具体取决于类型。对于 <input type="radio">（属于一个单选按钮组）和 <select>，任何先前选中的元素都将被取消选中。

使用此方法（或使用本机 value 属性）设置值不会导致 change 事件的派发。因此，相关的事件处理程序将不会执行。如果您想执行它们，您应该在设置值后调用 .trigger( "change" )。

.val() 方法允许通过传入一个函数来设置值。从 jQuery 1.4 开始，该函数传递两个参数，当前元素的索引及其当前值。

1
2
3
 
$( "input[type=text].tags" ).val(function( index, value ) {
  return value.trim();
});

此示例从具有 "tags" 类的文本输入的值中删除前导和尾随空格。

示例

设置输入框的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>val demo</title>
  <style>
  button {
    margin: 4px;
    cursor: pointer;
  }
  input {
    margin: 4px;
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>
  <button>Feed</button>
  <button>the</button>
  <button>Input</button>
</div>
<input type="text" value="click a button">
 
<script>
$( "button" ).on( "click", function() {
  var text = $( this ).text();
  $( "input" ).val( text );
});
</script>
 
</body>
</html>

演示

使用函数参数修改输入框的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>val demo</title>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>Type something and then click or tab out of the input.</p>
<input type="text" value="type something">
 
<script>
$( "input" ).on( "blur", function() {
  $( this ).val(function( i, val ) {
    return val.toUpperCase();
  });
});
</script>
 
</body>
</html>

演示

设置单选下拉框、多选下拉框、复选框和单选按钮。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>val demo</title>
  <style>
  body {
    color: blue;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<select id="single">
  <option>Single</option>
  <option>Single2</option>
</select>
 
<select id="multiple" multiple="multiple">
  <option selected="selected">Multiple</option>
  <option>Multiple2</option>
  <option selected="selected">Multiple3</option>
</select>
 
<br>
<input type="checkbox" name="checkboxname" value="check1"> check1
<input type="checkbox" name="checkboxname" value="check2"> check2
<input type="radio" name="r" value="radio1"> radio1
<input type="radio" name="r" value="radio2"> radio2
 
<script>
$( "#single" ).val( "Single2" );
$( "#multiple" ).val([ "Multiple2", "Multiple3" ]);
$( "input").val([ "check1", "check2", "radio1" ]);
</script>
 
</body>
</html>

演示