表單中「全選/全清/反選」複選框是後台管理系統、批量操作介面的標準功能。本文提供原生 DOM 實作完整範例,涵蓋取得複選框集合、三種操作邏輯、事件綁定,並延伸現代化 querySelectorAll + forEach 寫法與無障礙改進建議。
透過容器 id="Balls" 範圍,篩選 type="checkbox" 的 <input>:
function getAllCheckboxes() {
var container = document.getElementById("Balls");
var inputs = container.getElementsByTagName("input");
var checkboxes = [];
for (var i = 0; i < inputs.length; i++) {
if (inputs[i].type === "checkbox") {
checkboxes.push(inputs[i]);
}
}
return checkboxes;
}
function selectAll() {
var checkboxes = getAllCheckboxes();
for (var i = 0; i < checkboxes.length; i++) {
checkboxes[i].checked = true;
}
}
function clearAll() {
var checkboxes = getAllCheckboxes();
for (var i = 0; i < checkboxes.length; i++) {
checkboxes[i].checked = false;
}
}
function reverseAll() {
var checkboxes = getAllCheckboxes();
for (var i = 0; i < checkboxes.length; i++) {
checkboxes[i].checked = !checkboxes[i].checked;
}
}
<body>
<div id="Balls">
<input type="checkbox" id="c1" /><label for="c1">足球</label>
<input type="checkbox" id="c2" /><label for="c2">台球</label>
<input type="checkbox" id="c3" /><label for="c3">乒乓球</label>
<br />
<input type="button" value="全選" onclick="selectAll()" />
<input type="button" value="全清" onclick="clearAll()" />
<input type="button" value="反選" onclick="reverseAll()" />
</div>
</body>
// 取得複選框集合(NodeList 可直接 forEach)
const getCheckboxes = () => document.querySelectorAll('#Balls input[type="checkbox"]');
const selectAll = () => getCheckboxes().forEach(cb => cb.checked = true);
const clearAll = () => getCheckboxes().forEach(cb => cb.checked = false);
const reverseAll = () => getCheckboxes().forEach(cb => cb.checked = !cb.checked);
// 綁定事件(建議用 addEventListener 取代行內 onclick)
document.querySelector('#selectAllBtn').addEventListener('click', selectAll);
document.querySelector('#clearAllBtn').addEventListener('click', clearAll);
document.querySelector('#reverseAllBtn').addEventListener('click', reverseAll);
當部分複選框被選中時,父層「全選」複選框應顯示「半選」狀態(indeterminate = true),這是原生屬性,**無法透過 HTML 屬性設定,必須用 JS 設定**。
<input type="checkbox" id="selectAllCheckbox" /> <label for="selectAllCheckbox">全選</label>
<script>
const selectAllCb = document.getElementById('selectAllCheckbox');
const itemCbs = document.querySelectorAll('#Balls input[type="checkbox"]:not(#selectAllCheckbox)');
function updateSelectAllState() {
const checked = [...itemCbs].filter(cb => cb.checked).length;
const total = itemCbs.length;
if (checked === 0) {
selectAllCb.checked = false;
selectAllCb.indeterminate = false;
} else if (checked === total) {
selectAllCb.checked = true;
selectAllCb.indeterminate = false;
} else {
selectAllCb.checked = false;
selectAllCb.indeterminate = true; // 關鍵:半選狀態
}
}
// 子項變更時更新父項
itemCbs.forEach(cb => cb.addEventListener('change', updateSelectAllState));
// 父項點擊控制子項
selectAllCb.addEventListener('click', () => {
const shouldCheck = !selectAllCb.checked; // indeterminate 視為未選
itemCbs.forEach(cb => cb.checked = shouldCheck);
updateSelectAllState();
});
<input type="checkbox"> 綁定 <label for="id">indeterminate 正確設定)原生 DOM 實作複選框群組操作邏輯簡單,關鍵在於:
querySelectorAll 最佳)checked = true/false/!checkedindeterminate 半選狀態同步onclick,改用 addEventListener