val([val|fn|arr])

返回值

String,Array

概述

获得匹配元素的当前值。

在 jQuery 1.2 中,可以返回任意元素的值了。包括select。如果多选,将返回一个数组,其包含所选的值。

参数

参数 类型 说明 示例值
val String
v1.0

要设置的值

function(index, value) Function
v1.4

此函数返回一个要设置的值。接受两个参数,index为元素在集合中的索引位置,text为原先的text值。

array Array<String>
v1.0

用于 check/select 的值

示例

示例一

描述:获取文本框中的值

jQuery 代码

$("input").val();
示例二

描述:设定文本框的值

jQuery 代码

$("input").val("hello world!");
示例三

描述:设定文本框的值

jQuery 代码

$('input:text.items').val(function() {
  return this.value + ' ' + this.className;
});
示例四

设定一个select和一个多选的select的值

HTML 代码

<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" value="check1"/> check1
<input type="checkbox" value="check2"/> check2
<input type="radio" value="radio1"/> radio1
<input type="radio" value="radio2"/> radio2

jQuery 代码

$("#single").val("Single2");
$("#multiple").val(["Multiple2", "Multiple3"]);
$("input").val(["check2", "radio1"]);