萬盛學電腦網

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

JavaScript 限制核取方塊最多選取數量並彈出提示

需求場景

表單中有一組核取方塾,業務規定「最多只能勾選 N 個」,超過時自動取消勾選並彈出警告。

原始邏輯重構 (ES6+ 模組化寫法)

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
    <meta charset="UTF-8">
    <title>核取方塊數量限制 Demo</title>
    <style>
        .checkbox-group { display: flex; flex-direction: column; gap: 10px; max-width: 300px; margin: 20px auto; font-family: sans-serif; }
        .checkbox-item { display: flex; align-items: center; gap: 8px; cursor: pointer; }
        .checkbox-item input[type="checkbox"] { width: 18px; height: 18px; accent-color: #007bff; }
        .msg { text-align: center; color: #dc3545; margin-top: 10px; min-height: 1.2em; }
    </style>
</head>
<body>
    <fieldset class="checkbox-group" id="group">
        <legend>請最多選擇 2 項興趣</legend>
        <label class="checkbox-item"><input type="checkbox" value="coding"> 程式設計</label>
        <label class="checkbox-item"><input type="checkbox" value="reading"> 閱讀</label>
        <label class="checkbox-item"><input type="checkbox" value="sports"> 運動</label>
        <label class="checkbox-item"><input type="checkbox" value="music"> 音樂</label>
        <label class="checkbox-item"><input type="checkbox" value="travel"> 旅遊</label>
    </fieldset>
    <div class="msg" id="msg"></div>

    <script>
        const MAX_SELECT = 2;
        const group = document.getElementById("group");
        const msgEl = document.getElementById("msg");
        const checkboxes = group.querySelectorAll('input[type="checkbox"]');

        // 事件委派:綁在 fieldset 上,效能更好、動態新增也生效
        group.addEventListener("change", (e) => {
            const target = e.target;
            if (target.matches('input[type="checkbox"]')) {
                enforceLimit(target);
            }
        });

        function enforceLimit(changedCheckbox) {
            const checkedCount = Array.from(checkboxes).filter(cb => cb.checked).length;

            if (checkedCount > MAX_SELECT) {
                // 超過限制:取消「剛剛被勾選」的那一個
                changedCheckbox.checked = false;
                showMessage(`最多只能選擇 ${MAX_SELECT} 個項目!`);
            } else {
                clearMessage();
            }
        }

        function showMessage(text) {
            msgEl.textContent = text;
            msgEl.style.opacity = 1;
            // 可選:自動淡出
            // setTimeout(clearMessage, 2000);
        }
        function clearMessage() { msgEl.textContent = ""; msgEl.style.opacity = 0; }
    </script>
</body>
</html>

核心邏輯解析

  1. 事件委派:在父容器 fieldset 監聽 change 事件,而非逐個綁定,支援動態新增/移除核取方塊。
  2. 即時計數:Array.from(checkboxes).filter(cb => cb.checked).length 取得目前勾選數。
  3. 精準回滾:僅將「觸發本次 change 事件的元素」changedCheckbox.checked = false,保留使用者先前的選擇,體驗最佳。
  4. 非阻塞提示:使用頁面內訊息區而非 alert(),避免阻塞主執行緒且樣式可控。

進階擴充:取得已選值陣列

function getSelectedValues() {
    return Array.from(checkboxes)
        .filter(cb => cb.checked)
        .map(cb => cb.value);
}

// 表單送出前驗證
form.addEventListener("submit", (e) => {
    const selected = getSelectedValues();
    if (selected.length === 0) {
        e.preventDefault();
        showMessage("請至少選擇一項");
    } else if (selected.length > MAX_SELECT) {
        e.preventDefault(); // 理論上不會發生,雙重保險
        showMessage(`最多 ${MAX_SELECT} 項`);
    }
});

無障礙 (Accessibility) 加分項

  • 使用 <fieldset> + <legend> 群組相關核取方塊。
  • 每個 <input> 搭配 <label>,點擊文字即可切換。
  • 錯誤訊息加上 role="alert" 或 aria-live="polite",螢幕閱讀器可即時朗讀。

React / Vue 單向資料流寫法對照

// React Hooks 範例
const [checked, setChecked] = useState(new Set());
const handleChange = (value) => {
    const next = new Set(checked);
    if (next.has(value)) next.delete(value);
    else if (next.size < MAX_SELECT) next.add(value);
    else alert(`最多 ${MAX_SELECT} 項`);
    setChecked(next);
};

總結

核取方塊數量限制的關鍵在於「事件委派 + 即時計數 + 精準回滾」。現代寫法捨棄 alert() 改用內建提示區、善用 fieldset/legend 強化語意,並可無縫遷移至主流前端框架的受控元件模式中。

copyright © 萬盛學電腦網 all rights reserved