表單中「全選/反選/全不選」是經典需求。本文提供純 jQuery 實作,涵蓋事件綁定、狀態同步、效能優化與無障礙考量。
<table id="data-table">
<thead>
<tr>
<th><input type="checkbox" id="check-all"> 全選</th>
<th>名稱</th>
</tr>
</thead>
<tbody>
<tr><td><input type="checkbox" class="row-check" value="1"></td><td>項目 1</td></tr>
<tr><td><input type="checkbox" class="row-check" value="2"></td><td>項目 2</td></tr>
<tr><td><input type="checkbox" class="row-check" value="3"></td><td>項目 3</td></tr>
</tbody>
</table>
<button type="button" id="btn-invert">反選</button>
<button type="button" id="btn-none">全不選</button>
(function($) {
const $table = $('#data-table');
const $checkAll = $('#check-all');
const $rowChecks = $table.find('.row-check');
const $btnInvert = $('#btn-invert');
const $btnNone = $('#btn-none');
// 1. 全選/取消全選
$checkAll.on('change', function() {
const checked = this.checked;
$rowChecks.prop('checked', checked).trigger('change');
});
// 2. 反選
$btnInvert.on('click', function() {
$rowChecks.each(function() {
this.checked = !this.checked;
}).trigger('change');
});
// 3. 全不選
$btnNone.on('click', function() {
$rowChecks.prop('checked', false).trigger('change');
});
// 4. 子選項變更時同步「全選」狀態
$rowChecks.on('change', function() {
const total = $rowChecks.length;
const checked = $rowChecks.filter(':checked').length;
$checkAll.prop('checked', checked === total);
$checkAll.prop('indeterminate', checked > 0 && checked < total);
});
// 5. 取得已選值(表單提交前)
$('#submit-btn').on('click', function() {
const selected = $rowChecks.filter(':checked').map(function() {
return this.value;
}).get();
console.log('已選值:', selected); // ["1", "3"]
});
})(jQuery);
.prop() vs .attr().prop('checked', true):設定**屬性**,影響 DOM 狀態,觸發 change 事件,為正確做法。.attr('checked', 'checked'):設定**屬性值**,僅影響初始 HTML,不改變當前狀態,**不建議**用於動態切換。// 大量列表(>1000 行)建議使用事件代理
$table.on('change', '.row-check', function() {
// 同步全選狀態邏輯...
});
// 批次更新 DOM 避免重繪
const checked = $checkAll.prop('checked');
$rowChecks.each(function() { this.checked = checked; });
// 單次觸發 change 事件
$rowChecks.trigger('change');
indeterminate 狀態:視覺上顯示「部分選中」(水平線),螢幕閱讀器可識別。<button type="button"> 避免表單提交。const checkAll = document.getElementById('check-all');
const rowChecks = document.querySelectorAll('.row-check');
checkAll.addEventListener('change', () => {
rowChecks.forEach(cb => cb.checked = checkAll.checked);
});
// 反選
document.getElementById('btn-invert').addEventListener('click', () => {
rowChecks.forEach(cb => cb.checked = !cb.checked);
});
// 同步 indeterminate
function syncIndeterminate() {
const checked = [...rowChecks].filter(cb => cb.checked).length;
checkAll.indeterminate = checked > 0 && checked < rowChecks.length;
checkAll.checked = checked === rowChecks.length;
}
rowChecks.forEach(cb => cb.addEventListener('change', syncIndeterminate));
掌握核心邏輯後,無論使用 jQuery 或原生 JS,都能輕鬆實作穩健的複選框互動。