萬盛學電腦網

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

JavaScript 檢查 Checkbox 選中狀態:單個、群組、取值完整指南

場景一:表單中同名 Checkbox 群組

當多個 checkbox 共用同一 name 時,form.elements[name] 回傳 HTMLCollection;單個 checkbox 時直接回傳元素本身。

var f = document.form1;
var sum = 0;

if (f.checkbox1.length) {
    // 多個 checkbox:迴圈檢查
    for (var i = 0; i < f.checkbox1.length; i++) {
        if (f.checkbox1[i].checked === true) {
            sum++;
        }
    }
} else {
    // 單個 checkbox:直接檢查
    if (f.checkbox1.checked) {
        sum = 1;
    }
}
console.log("選中數量:", sum);

關鍵點:單個 checkbox 時 f.checkbox1.length 為 undefined,必須用 if (f.checkbox1.length) 區分。

場景二:使用 getElementsByName 取得群組

<script>
function test() {
    var x = document.getElementsByName("enjoy[]");
    var issel = false;
    for (var i = 0; i < x.length; i++) {
        if (x[i].checked) {
            issel = true;
            return issel; // 早期返回,效能較好
        }
    }
    return issel;
}
</script>

<body>
<form id="form1" name="form1" method="post" action="">
    <input type="checkbox" name="enjoy[]" id="enjoy[]" /> 吃
    <input type="checkbox" name="enjoy[]" id="enjoy[]" /> 喝
    <input type="submit" name="button" id="button" onclick="alert(test());" value="提交" />
</form>
</body>

現代 jQuery 寫法(推薦)

取得所有選中的值

var checkedValues = $('input[name="enjoy[]"]:checked').map(function() {
    return this.value;
}).get(); // 回傳陣列 ["吃", "喝"]

判斷是否有選中

var hasChecked = $('input[name="enjoy[]"]').is(':checked'); // true/false
// 或
var count = $('input[name="enjoy[]"]:checked').length;

取得第一個選中的值

var firstVal = $('input[name="enjoy[]"]:checked').val(); // 未選中時回傳 undefined

原生 JS 現代寫法(ES6+)

// 取得所有選中值
const checkedValues = Array.from(document.querySelectorAll('input[name="enjoy[]"]:checked'))
    .map(el => el.value);

// 判斷是否有選中
const hasChecked = document.querySelector('input[name="enjoy[]"]:checked') !== null;

// 計算選中數量
const count = document.querySelectorAll('input[name="enjoy[]"]:checked').length;

全選/反選/取消全選 實用函式

function toggleAll(checkboxName, checked) {
    document.querySelectorAll('input[name="' + checkboxName + '"]')
        .forEach(el => el.checked = checked);
}

// 使用範例
toggleAll('enjoy[]', true);  // 全選
toggleAll('enjoy[]', false); // 取消全選

// 反選
document.querySelectorAll('input[name="enjoy[]"]').forEach(el => el.checked = !el.checked);

表單提交時驗證至少勾選一項

form.addEventListener('submit', function(e) {
    const checked = form.querySelector('input[name="enjoy[]"]:checked');
    if (!checked) {
        alert('請至少選擇一項');
        e.preventDefault();
    }
});

總結

處理 checkbox 群組時,關鍵在於區分「單一元素」與「元素集合」。現代專案建議使用 querySelectorAll + :checked 偽類選擇器,語意清晰且無需判斷 length 存在性。

copyright © 萬盛學電腦網 all rights reserved