表單中 CheckBox 的操作是前端開發高頻需求。本文系統整理 12 種常見操作場景,從基礎值獲取到進階批次處理,提供標準化、可維護的 jQuery 實作方案。
// 標準選取器
$('input:checkbox') // 所有 checkbox
$('input[type="checkbox"]') // 屬性選取器寫法
$('input[name="ck"]') // 指定 name 群組
// 寫法一:標準偽類選取器
$('input:checkbox:checked').val();
// 寫法二:屬性選取器
$('input[type="checkbox"]:checked').val();
// 寫法三:指定 name 群組
$('input[name="ck"]:checked').val();
// 方式一:each 迴圈收集
var values = [];
$('input:checkbox:checked').each(function() {
values.push($(this).val());
});
// 方式二:map 映射(更簡潔)
var values = $('input:checkbox:checked').map(function() {
return this.value;
}).get(); // 返回原生陣列
// 方式三:逗號分隔字串
var csv = $('input:checkbox:checked').map(function() {
return this.value;
}).get().join(',');
// 現代 prop() 方法(jQuery 1.6+ 推薦)
$('input:checkbox:first').prop('checked', true);
// 或使用 eq()
$('input:checkbox').eq(0).prop('checked', true);
// 注意:原文誤用 :radio,此處修正為 :checkbox
$('input:checkbox:last').prop('checked', true);
$('input:checkbox').eq(-1).prop('checked', true);
// 單一索引
$('input:checkbox').eq(索引值).prop('checked', true);
// 範圍選取(索引 1 到 2,含頭不含尾)
$('input:checkbox').slice(1, 3).prop('checked', true);
// 選中第 1、2 項(索引 0,1)
$('input:checkbox').slice(0, 2).prop('checked', true);
$('input:checkbox[value="1"]').prop('checked', true);
$('input:checkbox[value="1"]').remove();
// 移除第 3 個(索引 2)
$('input:checkbox').eq(2).remove();
$('input:checkbox').each(function(index, domEle) {
// index: 索引值
// domEle: 原生 DOM 元素
// this: 同 domEle
console.log(index, this.value, this.checked);
});
// 標準全選
$('input:checkbox').prop('checked', true);
// 若有「全選」主控制 checkbox
$('#selectAll').on('change', function() {
$('input:checkbox').not(this).prop('checked', this.checked);
});
$('input:checkbox').prop('checked', false);
| 操作類型 | 推薦方法 | 避免使用 |
|---|---|---|
| 設定/讀取 checked 狀態 | .prop('checked', true/false) | .attr('checked', ...) |
| 判斷是否選中 | .is(':checked') 或 .prop('checked') | .attr('checked') |
| 事件綁定 | .on('change', handler) | .click()、內聯 onclick |
| 值獲取 | .val() | .attr('value') |
// 將表單所有 checkbox 整理為物件
var formData = {};
$('input:checkbox').each(function() {
var name = this.name;
if (!formData[name]) formData[name] = [];
if (this.checked) formData[name].push(this.value);
});
console.log(formData); // { "colors": ["red", "blue"], "sizes": ["M"] }
.prop(),.attr() 僅獲取初始 HTML 屬性值$(document).on('change', 'input:checkbox', handler)