萬盛學電腦網

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

原生 JavaScript 實現複選框全選、反選、全不選、獲取選中值

無依賴、零庫、純原生 JS 實現複選框組的全選/全不選/反選/確認獲取值,適合輕量級頁面、嵌入式組件、無框架環境。

HTML 結構

<div class="m-box">
    <h2 class="hd">選擇列表</h2>
    <ul class="bd" id="j-itemBox">
        <li><label><input type="checkbox" name="item" value="1"/> 選項1</label></li>
        <li><label><input type="checkbox" name="item" value="2"/> 選項2</label></li>
        <li><label><input type="checkbox" name="item" value="3"/> 選項3</label></li>
        <li><label><input type="checkbox" name="item" value="4"/> 選項4</label></li>
        <li><label><input type="checkbox" name="item" value="5"/> 選項5</label></li>
        <li><label><input type="checkbox" name="item" value="6"/> 選項6</label></li>
        <li><label><input type="checkbox" name="item" value="7"/> 選項7</label></li>
        <li><label><input type="checkbox" name="item" value="8"/> 選項8</label></li>
        <li><label><input type="checkbox" name="item" value="9"/> 選項9</label></li>
        <li><label><input type="checkbox" name="item" value="10"/> 選項10</label></li>
    </ul>
    <p class="ft">
        <label><input type="checkbox" id="j-checkAll"/> 全選</label>
        &nbsp;<a href="javascript:void(0);" id="j-checkReverse">反選</a>
        &nbsp;<a href="javascript:void(0);" id="j-checkOk">確定</a>
    </p>
</div>

CSS 樣式(精簡版)

<style>
.m-box { width: 400px; border: 1px #666 solid; margin: 20px auto; font: 12px/30px 'Microsoft YaHei'; }
.m-box .hd, .m-box .ft { background: #ccc; padding: 0 10px; }
.m-box .bd { max-height: 120px; overflow-y: auto; padding: 10px; }
.m-box .bd li { margin: 5px 0; }
</style>

核心 JS 類封裝(ES5 構造函數模式)

<script>
function Check(options) {
    this.oItemsBox = options.oItemsBox;      // 容器 ul
    this.aItems = options.aItems;            // NodeList: document.getElementsByName('item')
    this.oCheckAll = options.oCheckAll;      // 全選 checkbox
    this.oCheckReverse = options.oCheckReverse; // 反選鏈接
    this.oCheckOk = options.oCheckOk;        // 確定鏈接
}

Check.prototype = {
    init: function() {
        var that = this;
        
        // 1. 代理:容器點擊 → 更新全選狀態
        this.oItemsBox.onclick = function(e) {
            e = e || window.event;
            var target = e.target || e.srcElement;
            if (target.tagName.toLowerCase() === "input") {
                that.updateCheckAll();
            }
        };
        
        // 2. 全選/全不選
        this.oCheckAll.onclick = function() {
            that.checkAll();
        };
        
        // 3. 反選
        this.oCheckReverse.onclick = function() {
            that.checkReverse(true);
        };
        
        // 4. 確定:收集選中值並彈窗
        this.oCheckOk.onclick = function() {
            var selected = that.checkReverse(false); // 復用邏輯收集值
            alert("您選擇了 value 為:【" + selected.join(",") + "】的選項!");
        };
    },
    
    // 全選/全不選:同步所有項與全選框
    checkAll: function() {
        var checked = this.oCheckAll.checked;
        for (var i = 0, len = this.aItems.length; i < len; i++) {
            this.aItems[i].checked = checked;
        }
    },
    
    // 核心邏輯:反選 或 收集選中值
    // isReverse=true 時執行反選;false 時僅收集並更新全選框
    checkReverse: function(isReverse) {
        var selectedValues = [];
        var checkedCount = 0;
        var len = this.aItems.length;
        
        for (var i = 0; i < len; i++) {
            var item = this.aItems[i];
            if (isReverse) {
                item.checked = !item.checked; // 取反
            }
            if (item.checked) {
                checkedCount++;
                selectedValues.push(item.value);
            }
        }
        
        // 更新全選框狀態:全選當且僅當所有項都被選中
        this.oCheckAll.checked = (checkedCount === len);
        
        return selectedValues; // 返回選中值陣列
    }
};

// 實例化
var myCheck = new Check({
    oItemsBox: document.getElementById("j-itemBox"),
    aItems: document.getElementsByName("item"),
    oCheckAll: document.getElementById("j-checkAll"),
    oCheckReverse: document.getElementById("j-checkReverse"),
    oCheckOk: document.getElementById("j-checkOk")
});

myCheck.init();
</script>

關鍵邏輯解析

  1. 事件代理:在 ul 上綁定 onclick,判斷 target 是否為 input,避免給 10 個 checkbox 綁 10 個事件
  2. 狀態同步:checkAll 以「全選框狀態」為準同步所有項;checkReverse 以「項狀態」反推全選框
  3. 復用邏輯:checkReverse 同時服務「反選操作」與「確定收集值」(isReverse=false 時不翻轉,只統計)
  4. 兼容性:e || window.event、target || srcElement、tagName.toLowerCase() 覆蓋 IE8+

現代 ES6+ 重寫(模塊化、箭頭函數、const/let)


class CheckboxGroup {
    constructor(containerSelector, itemName, checkAllId, reverseId, okId) {
        this.$box = document.querySelector(containerSelector);
        this.items = [...document.getElementsByName(itemName)];
        this.checkAll = document.getElementById(checkAllId);
        this.reverseBtn = document.getElementById(reverseId);
        this.okBtn = document.getElementById(okId);
        this.bindEvents();
    }
    
    bindEvents() {
        this.$box.addEventListener("click", e => {
            if (e.target.matches("input[name=" + this.items[0].name + "]")) {
                this.updateCheckAll();
            }
        });
        this.checkAll.addEventListener("change", () => this.checkAll());
        this.reverseBtn.addEventListener("click", () => this.checkReverse(true));
        this.okBtn.addEventListener("click", () => {
            const vals = this.checkReverse(false);
            alert(`選中值: ${vals.join(",")}`);
        });
    }
    
    checkAll() {
        this.items.forEach(item => item.checked = this.checkAll.checked);
    }
    
    checkReverse(isReverse) {
        const selected = [];
        this.items.forEach(item => {
            if (isReverse) item.checked = !item.checked;
            if (item.checked) selected.push(item.value);
        });
        this.checkAll.checked = selected.length === this.items.length;
        return selected;
    }
    
    updateCheckAll() {
        const checked = this.items.filter(i => i.checked).length;
        this.checkAll.checked = checked === this.items.length;
        this.checkAll.indeterminate = checked > 0 && checked < this.items.length; // 三態:半選
    }
}

// 使用
new CheckboxGroup("#j-itemBox", "item", "j-checkAll", "j-checkReverse", "j-checkOk");

進階:半選狀態

HTML5 indeterminate 屬性(僅 JS 設置,無 HTML 屬性)可視覺化「部分選中」:

this.checkAll.indeterminate = checked > 0 && checked < this.items.length;

結語

原生 JS 實現複選框交互零依賴、體積極小(壓縮後 < 1KB)、無運行時開銷。理解「事件代理、狀態單向流、邏輯復用」三大設計思想,可輕鬆擴展「全選不可選項、分組全選、鍵盤空格選中、虛擬列表」等高級功能。

copyright © 萬盛學電腦網 all rights reserved