HTML 結構
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<label><input type="checkbox" id="selectAll"> 全選</label>
<label><input type="checkbox" id="reverse"> 反選</label>
<label><input type="checkbox" id="checkItems"> 切換</label>
<hr>
<ul id="itemList">
<li><label><input type="checkbox" name="subBox" value="1"> 項目 1</label></li>
<li><label><input type="checkbox" name="subBox" value="2"> 項目 2</label></li>
<li><label><input type="checkbox" name="subBox" value="3"> 項目 3</label></li>
<li><label><input type="checkbox" name="subBox" value="4"> 項目 4</label></li>
<li><label><input type="checkbox" name="subBox" value="5"> 項目 5</label></li>
</ul>
jQuery 邏輯
$(function() {
var $items = $('input[name="subBox"]');
// 全選
$('#selectAll').on('change', function() {
$items.prop('checked', this.checked);
});
// 反選
$('#reverse').on('click', function() {
$items.each(function() {
this.checked = !this.checked;
});
syncSelectAll();
});
// 切換 (同反選,語意不同)
$('#checkItems').on('click', function() {
$items.each(function() {
this.checked = !this.checked;
});
syncSelectAll();
});
// 子項目變更 → 同步「全選」狀態
$items.on('change', syncSelectAll);
function syncSelectAll() {
var total = $items.length;
var checked = $items.filter(':checked').length;
$('#selectAll').prop('checked', total === checked && total > 0)
.prop('indeterminate', checked > 0 && checked < total);
}
});
關鍵 API 對照
| 需求 | 方法 | 說明 |
| 設定/取得勾選狀態 | .prop('checked', true/false) | **推薦** (jQuery 1.6+),對應 DOM property |
| 舊版相容 | .attr('checked', 'checked') | 屬性操作,行為不一致 |
| 原生 DOM 切換 | this.checked = !this.checked | 效能最好,無 jQuery 開銷 |
| 半選狀態 | .prop('indeterminate', true) | 視覺上呈現「部分選取」 |
進階:取得已選值
$('#getSelected').click(function() {
var vals = $items.filter(':checked').map(function() {
return this.value;
}).get(); // ["1", "3", "5"]
console.log('選中:', vals.join(','));
});
原生 JS 版 (無依賴)
document.addEventListener('DOMContentLoaded', () => {
const items = document.querySelectorAll('input[name="subBox"]');
const selectAll = document.getElementById('selectAll');
const reverse = document.getElementById('reverse');
selectAll.addEventListener('change', () =>
items.forEach(i => i.checked = selectAll.checked)
);
reverse.addEventListener('click', () => {
items.forEach(i => i.checked = !i.checked);
sync();
});
items.forEach(i => i.addEventListener('change', sync));
function sync() {
const total = items.length;
const checked = [...items].filter(i => i.checked).length;
selectAll.checked = total === checked && total > 0;
selectAll.indeterminate = checked > 0 && checked < total;
}
});