表單提交前驗證、批次操作、資料收集等場景常需遍歷檢查 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);
});
$('#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 | 更函數式、可鏈式 |
// 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);
}
});
// 原生 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;
}