.val()【要素値 取得・設定】
メモ
- 要素値 取得
- 先頭要素の要素値を取得
- 下記の要素等が対象
<input>【汎用入力コントロール】
<select>【選択リスト】
<textarea>【複数行入力コントロール】 - 次の選択項目値を取得する場合、:checked【チェック状態・選択状態 要素】セレクタを使用
<select>【選択リスト】(セレクタ未使用でも取得可)
<input>【汎用入力コントロール】チェックボックス (HTML で value 指定)
<input>【汎用入力コントロール】ラジオボタン
- 要素値 設定
- 全ての該当要素の要素値を設定
構文
説明 | 構文 | 戻り値 | 備考 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要素値 取得 | .val() 1.0 | String Number Array ※1 undefined:該当要素なし | ※1複数選択が可能な要素で使用 選択項目なし:空配列 3.0 (null:jQuery 3.0 以前) | |||||||||||
要素値 設定 | .val( value ) 1.0 String | Number | Array ※2 value:要素値 | jQuery | ※2下記で使用 <input>【汎用入力コントロール】のチェックボックス <input>【汎用入力コントロール】のラジオボタン <select>【選択リスト】 | |||||||||||
.val( function ) 1.4 function:
| jQuery |
関連
- jQuery リファレンス メモ
- .attr()【属性値 取得・設定】
- .removeAttr()【属性削除】
- .prop()【プロパティ値 取得・設定】
- .removeProp()【プロパティ削除】
- jQuery (英語)
例
<style>
.arrow { font-size:x-large; }
.arrow:before { content:" → " }
</style>
<p><!--<input>-->
<input id="textFrom" type="text" value="textFrom">
<span class="arrow"></span>
<input id="textTo" type="text" value="textTo">
</p>
<p><!--<input type="checkbox" value="~">-->
<label><input id="checkboxFrom1" type="checkbox" value="CHECKBOX1" checked>checkboxFrom1 (value属性あり)</label>
<span class="arrow"></span>[<span id="checkboxValue1"></span>]
<label><input id="checkboxTo1" type="checkbox" value="CHECKBOX1">checkboxTo1</label>
</p>
<p><!--<input type="checkbox">-->
<label><input id="checkboxFrom2" type="checkbox" checked>checkboxFrom2 (value属性なし)</label>
<span class="arrow"></span>[<span id="checkboxValue2"></span>]
<label><input id="checkboxTo2" type="checkbox">checkboxTo2</label>
</p>
<p><!--<input type="radio" name="~" value="~">-->
<label><input name="radioFrom" type="radio" value="RADIO1" checked>radioFrom (RADIO1)</label>
<label><input name="radioFrom" type="radio" value="RADIO2">radioFrom (RADIO2)</label>
<span class="arrow"></span>[<span id="radioValue"></span>]
<label><input name="radioTo" type="radio" value="RADIO1">radioTo (RADIO1)</label>
<label><input name="radioTo" type="radio" value="RADIO2" checked>radioTo (RADIO2)</label>
</p>
<p><!--<select size="1">-->
<select id="selectFrom1" size="1">
<option value="1" selected>項目1
<option value="2">項目2
<option value="3">項目3
</select>
<span class="arrow"></span>[<span id="selectValue1"></span>]
<select id="selectTo1" size="1">
<option value="1">項目1
<option value="2" selected>項目2
<option value="3">項目3
</select>
</p>
<p><!--<select size="3">-->
<select id="selectFrom2" size="3">
<option value="a" selected>項目a
<option value="b">項目b
<option value="c">項目c
</select>
<span class="arrow"></span>[<span id="selectValue2"></span>]
<select id="selectTo2" size="3">
<option value="a">項目a
<option value="b" selected>項目b
<option value="c">項目c
</select>
</p>
<p><!--<select size="3" multiple>-->
<select id="selectFrom3" size="3" multiple>
<option value="A" selected>項目A
<option value="B" selected>項目B
<option value="C">項目C
</select>
<span class="arrow"></span>[<span id="selectValue3"></span>]
<select id="selectTo3" size="3" multiple>
<option value="A">項目A
<option value="B" selected>項目B
<option value="C" selected>項目C
</select>
</p>
<p><!--<textarea>-->
<textarea id="textareaFrom">textareaFrom</textarea>
<span class="arrow"></span>
<textarea id="textareaTo">textareaTo</textarea>
</p>
<script>
// <input>
$("#textFrom").change(function() {
$("#textTo").val( $(this).val() );
});
// <input type="checkbox" value="~">
$("#checkboxFrom1").change(function() {
var value = $("#checkboxFrom1:checked").val();
$("#checkboxValue1").text( (value === undefined) ? "undefined" : value );
$("#checkboxTo1").val( [ value ] );
});
// <input type="checkbox">
$("#checkboxFrom2").change(function() {
var value = $(this).is(":checked");
$("#checkboxValue2").text(value);
$("#checkboxTo2").prop("checked", value);
});
// <input type="radio" name="~" value="~">
$("input[name='radioFrom']").change(function() {
var value = $("input[name='radioFrom']:checked").val();
$("#radioValue").text( (value === undefined) ? "undefined" : value );
$("input[name='radioTo']").val( [ value ] );
});
// <select size="1">
$("#selectFrom1").change(function() {
var value = $(this).val();
var text = typeof value + ":" + value;
$("#selectValue1").text(text);
$("#selectTo1").val(value);
});
// <select size="3">
$("#selectFrom2").change(function() {
var value = $(this).val();
var text = typeof value + ":" + value;
$("#selectValue2").text(text);
$("#selectTo2").val(value);
});
// <select size="3" multiple>
$("#selectFrom3").change(function() {
var value = $(this).val();
var text = ($.isArray(value)) ? "Array" : "not Array";
text += " (" + value.length + "):" + value;
$("#selectValue3").text(text);
$("#selectTo3").val(value);
});
// <textarea>
$("#textareaFrom").change(function() {
$("#textareaTo").val( $("#textareaFrom").val() );
});
</script>
[]
[]
[]
[]
[]
[]
<p>
<input id="text2" value="aBcDeF">
<button id="toUpperCase">toUpperCase()</button>
<button id="toLowerCase">toLowerCase()</button>
</p>
<script>
$("#toUpperCase").click(function() {
$("#text2").val(function(index, value) {
return value.toUpperCase();
});
});
$("#toLowerCase").click(function() {
$("#text2").val(function(index, value) {
return value.toLowerCase();
});
});