萬盛學電腦網

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

jQuery val() 方法完整指南:表單值讀寫、多選處理、動態設置實戰詳解

val() 核心功能速查

呼叫形式用途返回值適用元素
.val()讀取值字串 / 陣列 / nullinput, select, textarea
.val(value)設置值jQuery 物件 (鏈式)input, select, textarea
.val(function)函數設置值jQuery 物件input, select, textarea

完整互動範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery val() 方法示範</title>
  <style>
    .container { max-width: 600px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
    .form-group { margin: 16px 0; display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
    label { min-width: 100px; font-weight: 500; }
    input, select, textarea { flex: 1; min-width: 200px; padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; font-size: 14px; }
    textarea { min-height: 80px; resize: vertical; }
    .controls { display: flex; gap: 10px; flex-wrap: wrap; margin: 20px 0; }
    button { padding: 10px 20px; background: #1976d2; color: white; border: none; border-radius: 6px; cursor: pointer; }
    button.secondary { background: #757575; }
    button.success { background: #4caf50; }
    .result { background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; white-space: pre-wrap; }
  </style>
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
  <div class="container">
    <h2>jQuery val() 綜合示範</h2>
    
    <div class="form-group">
      <label>單行文字:</label>
      <input type="text" id="txtName" value="初始文字">
    </div>
    <div class="form-group">
      <label>數字輸入:</label>
      <input type="number" id="txtAge" value="25">
    </div>
    <div class="form-group">
      <label>下拉單選:</label>
      <select id="selCity">
        <option value="bj">北京</option>
        <option value="sh" selected>上海</option>
        <option value="gz">廣州</option>
        <option value="sz">深圳</option>
      </select>
    </div>
    <div class="form-group">
      <label>下拉多選:</label>
      <select id="selMulti" multiple size="4">
        <option value="js">JavaScript</option>
        <option value="ts" selected>TypeScript</option>
        <option value="vue" selected>Vue</option>
        <option value="react">React</option>
      </select>
    </div>
    <div class="form-group">
      <label>多行文字:</label>
      <textarea id="txtDesc">初始描述內容</textarea>
    </div>
    <div class="form-group">
      <label>核取方塊:</label>
      <div>
        <label><input type="checkbox" name="skill" value="html" checked> HTML</label>
        <label><input type="checkbox" name="skill" value="css"> CSS</label>
        <label><input type="checkbox" name="skill" value="js" checked> JavaScript</label>
      </div>
    </div>
    <div class="form-group">
      <label>單選按鈕:</label>
      <div>
        <label><input type="radio" name="gender" value="male" checked> 男</label>
        <label><input type="radio" name="gender" value="female"> 女</label>
      </div>
    </div>

    <div class="controls">
      <button id="btnGetAll">獲取所有值</button>
      <button id="btnSetAll" class="success">批量設置值</button>
      <button id="btnFuncSet" class="secondary">函數動態設置</button>
      <button id="btnClear" class="secondary">清空表單</button>
    </div>
    <div class="result" id="result">點擊按鈕查看結果</div>
  </div>

  <script>
  $(function() {
    const $result = $('#result');
    const log = (msg) => $result.text(msg);

    // 1. 獲取所有表單值
    $('#btnGetAll').on('click', () => {
      const data = {
        name: $('#txtName').val(),
        age: $('#txtAge').val(),
        city: $('#selCity').val(),
        skills: $('#multiSel').val(), // 多選返回陣列
        desc: $('#txtDesc').val(),
        gender: $('input[name="gender"]:checked').val() // 單選需用 :checked
      };
      log(JSON.stringify(data, null, 2));
    });

    // 2. 批量設置值
    $('#btnSetAll').on('click', () => {
      $('#txtName').val('張三');
      $('#txtAge').val(30);
      $('#selCity').val('gz');
      $('#selMulti').val(['js', 'vue', 'react']); // 多選傳陣列
      $('#txtDesc').val('這是通過 val() 批量設置的內容');
      $('input[name="skill"]').val(['html', 'js']); // 核取方塊傳陣列
      $('input[name="gender"]').val(['female']); // 單選也可用陣列
      log('已批量設置所有表單值');
    });

    // 3. 函數動態設置 (根據索引/當前值計算)
    $('#btnFuncSet').on('click', () => {
      $('input[type="text"], textarea').val(function(i, oldVal) {
        return `第 ${i+1} 個輸入框 - 原值: ${oldVal}`;
      });
      log('已使用函數動態設置文字類輸入框');
    });

    // 4. 清空表單
    $('#btnClear').on('click', () => {
      $('input, select, textarea').val(''); // 多選需傳空陣列 []
      $('input[type="checkbox"], input[type="radio"]').prop('checked', false);
      log('表單已清空');
    });
  });
  </script>
</body>
</html>

關鍵細節深度解析

1. 不同元素類型的 val() 行為差異

元素類型.val() 返回.val(value) 設置
<input type="text/password/email/number...>字串字串/數值 → 字串
<textarea>字串 (含換行)字串
<select> (單選)字串 (選中 option 的 value)字串 → 選中對應 value 的 option
<select multiple>陣列 (所有選中 option 的 value)陣列 → 選中所有匹配 value 的 option
<input type="checkbox">字串 (第一個被勾選的 value) ⚠️陣列 → 勾選所有匹配 value
<input type="radio">字串 (被勾選的 value)陣列/字串 → 勾選匹配 value

2. 核取方塊群組取值:不要用 .val()

// ❌ 錯誤:只返回第一個勾選的值
$('input[name="skill"]').val(); // "html"

// ✅ 正確:用 map 獲取所有勾選值
const skills = $('input[name="skill"]:checked').map((_, el) => el.value).get(); // ["html", "js"]

3. .val([]) 清空多選 / 核取方塊群組

// 清空多選下拉框
$('#selMulti').val([]);

// 清空核取方塊群組
$('input[name="skill"]').val([]); // jQuery 3.0+ 支援
// 或
$('input[name="skill"]').prop('checked', false); // 通用做法

4. 函數參數:(index, currentValue) => newValue

// 為所有輸入框添加前綴
$('input[type="text"]').val((i, val) => `項目${i+1}: ${val}`);

// 將所有數字輸入框數值乘 2
$('input[type="number"]').val((i, val) => parseFloat(val) * 2 || 0);

實戰模式:表單資料雙向綁定

class FormBinder {
  constructor(formSelector) {
    this.$form = $(formSelector);
    this.bindInputs();
  }
  
  bindInputs() {
    this.$form.on('input change', 'input, select, textarea', (e) => {
      const $el = $(e.target);
      const name = $el.attr('name');
      if (name) this.data[name] = this.getValue($el);
    });
  }
  
  getValue($el) {
    if ($el.is('select[multiple]')) return $el.val() || [];
    if ($el.is('input[type="checkbox"]')) {
      return $('input[name="' + $el.attr('name') + '"]:checked').map((_,e)=>e.value).get();
    }
    return $el.val();
  }
  
  setData(data) {
    this.data = data;
    Object.entries(data).forEach(([name, value]) => {
      const $el = this.$form.find(`[name="${name}"]`);
      if ($el.is('select[multiple]') || $el.is('input[type="checkbox"]')) {
        $el.val(Array.isArray(value) ? value : [value]);
      } else {
        $el.val(value);
      }
    });
  }
  
  getData() { return this.data; }
}

避坑指南

⚠ 常見錯誤:
  • $('#sel').val('not-exist'):不報錯但無效果,下拉框顯示空白/第一項
  • $('input[name="x"]').val() 取核取方塊群組值 → 只得第一個
  • 動態新增 <option> 後直接 .val() 設置 → 需確保 option 已渲染到 DOM
  • .val(null) 在某些版本會報錯,清空請用 .val('') 或 .val([])

總結

val() 是 jQuery 表單操作的核心。掌握 單選返回字串、多選返回陣列、設置多選/核取方塊傳陣列、函數動態計算 這四大模式,加上 :checked 處理單選/核取方塊群組,即可應對所有表單取值設置場景。

copyright © 萬盛學電腦網 all rights reserved