萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript DOM Checkbox 全選、全清、反選完整實作指南

表單中「全選/全清/反選」複選框是後台管理系統、批量操作介面的標準功能。本文提供原生 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;
    }
}

完整 HTML 範例

<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>

現代化重構:ES6 + querySelectorAll

// 取得複選框集合(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 狀態(半選狀態)

當部分複選框被選中時,父層「全選」複選框應顯示「半選」狀態(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();
});

無障礙(Accessibility)檢查清單

  • ✅ 每個 <input type="checkbox"> 綁定 <label for="id">
  • ✅ 鍵盤可聚焦、Space 鍵切換
  • ✅ 螢幕閱讀器可正確朗讀狀態(需 indeterminate 正確設定)
  • ✅ 高對比度模式下可見

總結

原生 DOM 實作複選框群組操作邏輯簡單,關鍵在於:

  1. 正確取得目標複選框集合(querySelectorAll 最佳)
  2. 三大操作對應 checked = true/false/!checked
  3. 進階需求加入 indeterminate 半選狀態同步
  4. 現代專案請棄用行內 onclick,改用 addEventListener
copyright © 萬盛學電腦網 all rights reserved