萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 表單元素值獲取與設置完全指南:val() 方法深度解析

val() 方法核心用法

jQuery .val() 是處理表單元素值的統一介面,支援 <input>、<select>、<textarea>、單選/複選框等所有表單控制項。統一 API 避免了原生 JS 需區分 .value、.checked、.selectedIndex 的麻煩。

基本操作

獲取值(無參數)

// 文字輸入框
var textVal = $("input#mytextbox").val();

// 下拉選單(取得選中 option 的 value)
var selectVal = $("select#mylist").val();

// 單選按鈕(取得同 name 群組中被選中的 value)
var radioVal = $("input[name='myradio']:checked").val();

// 複選框(取得第一個被勾選的 value,通常配合 map() 取所有)
var checkboxVal = $("input[name='mycheck']:checked").val();

// 多選下拉選單(回傳陣列)
var multiSelectVal = $("select[multiple]").val(); // ["val1", "val2"]

設置值(帶參數)

// 文字輸入框
$("input#mytextbox").val("新內容");

// 下拉選單(依 value 選中對應 option)
$("select#mylist").val("第一列");

// 單選按鈕(依 value 選中對應 radio)
$("input[name='myradio']").val("2");  // 會自動勾選 value="2" 的那個

// 複選框(需傳陣列,一次勾選多個)
$("input[name='mycheck']").val(["val1", "val3"]);

// 多選下拉選單
$("select[multiple]").val(["opt1", "opt3"]);

進階技巧與常見坑

1. 取得/設定多選框所有值

// 獲取所有勾選值(陣列)
var checkedValues = $("input[name='fruit']:checked").map(function() {
  return this.value;
}).get();

// 設置多選框(傳入陣列)
$("input[name='fruit']").val(["apple", "banana"]);

2. 觸發 change 事件

.val() 設置值不會自動觸發 change 事件。若有綁定 change 監聽器,需手動觸發:

$("select#mylist").val("新值").trigger("change");

3. 檢索原生 DOM 元素的值(效能考量)

// 單一元素,原生更快
var val = document.getElementById("mytextbox").value;

// 批量操作時 jQuery 更方便
$("input:text").val(function(index, oldVal) {
  return oldVal.trim().toUpperCase();
});

4. 唯讀/禁用元素的值操作

// 唯讀輸入框可讀可寫
$("input[readonly]").val("新值");  // 可寫入

// 禁用元素可讀,但表單提交時不會發送
$("input[disabled]").val("新值");  // 可寫入,但不會隨表單提交

實戰範例:表單資料序列化與填充

表單轉 JSON 物件

$.fn.serializeObject = function() {
  var obj = {};
  $.each(this.serializeArray(), function(i, item) {
    if (obj[item.name] !== undefined) {
      if (!$.isArray(obj[item.name])) obj[item.name] = [obj[item.name]];
      obj[item.name].push(item.value);
    } else {
      obj[item.name] = item.value;
    }
  });
  return obj;
};

// 使用
var formData = $("#myForm").serializeObject();
// { name: "張三", age: "25", hobby: ["reading", "swimming"] }

JSON 物件填充表單

$.fn.populateForm = function(data) {
  return this.each(function() {
    var $form = $(this);
    $.each(data, function(name, value) {
      var $field = $form.find("[name='" + name + "']");
      if ($field.length) {
        if ($field.is(":radio")) {
          $field.filter("[value='" + value + "']").prop("checked", true);
        } else if ($field.is(":checkbox")) {
          var vals = $.isArray(value) ? value : [value];
          $field.each(function() {
            this.checked = $.inArray($(this).val(), vals) >= 0;
          });
        } else {
          $field.val(value);
        }
      }
    });
  });
};

// 使用
$("#myForm").populateForm({
  name: "李四",
  gender: "female",
  skills: ["js", "css"]
});

val() vs prop() vs attr()

方法適用場景備註
.val()表單元素目前值使用者輸入後的即時值
.prop('checked')checkbox/radio 勾選狀態布林值,jQuery 1.6+ 推薦
.attr('value')input 初始 value 屬性不會反映使用者輸入變化
.prop('selectedIndex')select 選中索引單選下拉適用
.prop('selected', true)設定 option 選中需針對 option 元素操作

總結

.val() 是 jQuery 表單操作的瑞士刀。記住三個核心原則:

  1. 統一介面:所有表單控制項同一套 API
  2. 雙向綁定:無參獲取、有參設置
  3. 陣列支援:多選場景自動處理陣列

搭配 .serialize()、.serializeArray()、自訂 serializeObject()/populateForm(),即可構建完整的表單資料流管理解決方案。

copyright © 萬盛學電腦網 all rights reserved