萬盛學電腦網

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

jQuery 遍歷表單檢查 CheckBox 選中狀態完整實作指南

jQuery 表單 CheckBox 狀態檢查與遍歷處理最佳實踐

表單提交前驗證、批次操作、資料收集等場景常需遍歷檢查 CheckBox 選中狀態。本文提供標準化、高效能的 jQuery 實作模式,涵蓋單選/多選、值收集、反選、全選等核心場景。

核心選取器與檢查方法


// 1. 選取表單內所有 checkbox
var $checkboxes = $('#tbl').find(':checkbox');
// 等同於
var $checkboxes = $('#tbl input[type="checkbox"]');

// 2. 檢查單一元素是否選中 (三種等效寫法)
$checkbox.is(':checked');        // 最推薦:語意清晰、效能佳
$checkbox.prop('checked');       // 原生屬性存取,最快
$checkbox.attr('checked');       // ❌ 僅獲取初始 HTML 屬性,不反映當前狀態
$checkbox[0].checked;            // 原生 DOM 屬性,極快

完整遍歷處理模式

場景一:收集所有被選中的值


// 方式一:map + get (最簡潔、標準)
var selectedValues = $('#tbl').find(':checkbox:checked').map(function() {
  return this.value; // 或 $(this).val()
}).get(); // 返回原生陣列 ['val1', 'val2', ...]

// 方式二:each 迴圈 (需複雜邏輯時)
var selectedValues = [];
$('#tbl').find(':checkbox:checked').each(function() {
  selectedValues.push(this.value);
});

// 方式三:現代 ES6 + jQuery
var selectedValues = [...$('#tbl').find(':checkbox:checked')].map(el => el.value);

場景二:驗證至少勾選一項


function validateAtLeastOneChecked(formSelector) {
  var hasChecked = $(formSelector).find(':checkbox:checked').length > 0;
  if (!hasChecked) {
    alert('請至少選擇一項');
    return false;
  }
  return true;
}

// 表單提交攔截
$('#myForm').on('submit', function(e) {
  if (!validateAtLeastOneChecked(this)) {
    e.preventDefault();
  }
});

場景三:取得選中項的完整資料物件


// 假設 checkbox 有 data-* 屬性攜帶完整資料
// 

var selectedItems = $('#tbl').find(':checkbox:checked').map(function() {
  return {
    id: this.value,
    name: $(this).data('name'),
    price: $(this).data('price'),
    // 也可取得父列的其他資料
    row: $(this).closest('tr').index()
  };
}).get();

console.log(selectedItems);
// [{id: "1", name: "Item A", price: 100, row: 0}, ...]

場景四:反選 / 全選 / 全不選


// 全選
$('#selectAll').on('change', function() {
  $('#tbl').find(':checkbox').not(this).prop('checked', this.checked);
});

// 反選
$('#invertSelect').on('click', function() {
  $('#tbl').find(':checkbox').each(function() {
    this.checked = !this.checked; // 原生屬性切換最快
  });
});

// 全不選
$('#selectNone').on('click', function() {
  $('#tbl').find(':checkbox').prop('checked', false);
});

場景五:限制最多選 N 項


$('#tbl').find(':checkbox').on('change', function() {
  var max = 3;
  var checkedCount = $('#tbl').find(':checkbox:checked').length;
  
  if (checkedCount > max) {
    this.checked = false; // 撤銷本次選擇
    alert(`最多只能選擇 ${max} 項`);
  }
});

效能優化關鍵點

操作推薦寫法避免寫法理由
判斷選中el.checked / $(el).prop('checked')$(el).attr('checked')attr 只讀初始屬性
設定選中el.checked = true / .prop('checked', true).attr('checked', 'checked')prop 操作 property
批次操作原生迴圈 + el.checked.each() 內用 $(this)避免 jQuery 封裝開銷
收集值.map(fn).get().each() push更函數式、可鏈式

原生 JavaScript 替代方案 (零依賴、更快)


// 1. 選取
const checkboxes = document.querySelectorAll('#tbl input[type="checkbox"]');

// 2. 收集選中值 (最現代)
const selectedValues = [...checkboxes]
  .filter(cb => cb.checked)
  .map(cb => cb.value);

// 3. 檢查是否有選中
const hasChecked = [...checkboxes].some(cb => cb.checked);

// 4. 全選/全不選
checkboxes.forEach(cb => cb.checked = true/false);

// 5. 反選
checkboxes.forEach(cb => cb.checked = !cb.checked);

// 6. 事件委託 (動態表單)
document.getElementById('tbl').addEventListener('change', (e) => {
  if (e.target.matches('input[type="checkbox"]')) {
    console.log('Changed:', e.target.value, e.target.checked);
  }
});

進階:表單資料序列化 (含 CheckBox 正確處理)


// 原生 FormData 自動處理:同 name 多值會自動合併
const formData = new FormData(document.getElementById('myForm'));

// 手動序列化為物件 (處理 checkbox 未勾選不發送的問題)
function serializeForm(form) {
  const data = {};
  const formData = new FormData(form);
  
  // 先收集所有 checkbox name (含未勾選)
  const checkboxNames = [...new Set(
    [...form.querySelectorAll('input[type="checkbox"]')].map(cb => cb.name)
  )];
  
  checkboxNames.forEach(name => {
    const values = formData.getAll(name);
    data[name] = values.length > 1 ? values : (values[0] || '');
  });
  
  // 其他欄位
  [...new FormData(form)].forEach(([key, val]) => {
    if (!data.hasOwnProperty(key)) data[key] = val;
  });
  
  return data;
}

無障礙 (a11y) 檢查清單

  • 每個 checkbox 有對應 `
  • 群組用 `
    ` + `` 包裹
  • 必要時加上 `aria-describedby` 說明選項用途
  • 鍵盤可操作:Tab 移動、Space 切換
  • 焦點樣式明顯 (`:focus-visible`)
copyright © 萬盛學電腦網 all rights reserved