DIV CSS 佈局教程網

JavaScript 檢查 checkbox 是否選中:單個與多個場景的完整處理
編輯:JavaScript綜合知識     

統計勾選數量、判斷是否至少選了一項,這類需求看起來平凡,但有一個非常容易忽略的坑——當頁面上只有一個 checkbox 時,.length 的返回值會讓判斷邏輯徹底失效。

一、場景假設

假設有一個名為 form1 的表單,裡面有一個名為 checkbox1 的勾選框。

二、兼容單個與多個的寫法

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

if (f.checkbox1.length) {
    // 多個 checkbox:length 有值,遍歷統計
    for (var i = 0; i < f.checkbox1.length; i++) {
        if (f.checkbox1[i].checked == true) {
            sum = sum + 1;
        }
    }
} else {
    // 只有一個 checkbox:length 為 undefined,直接判斷本身
    if (f.checkbox1.checked) {
        sum = 1;
    }
}

console.log(sum);

這裡的關鍵就在最外層的 if。當表單中同名的 checkbox 只有一個時,f.checkbox1 返回的是單個元素對象而不是集合,此時訪問 .length 得到 undefined,直接進入 else 分支。如果省掉這個判斷,單個 checkbox 的場景下循環一次都不會執行,統計結果永遠是 0。

這個行為並非 bug,而是 DOM 表單訪問機制的固有設計:同名元素返回 HTMLCollection,唯一元素返回元素本身。寫代碼時必須把兩種情況都照顧到。

三、用 getElementsByName 統一處理

如果不想寫分支,可以改用始終返回集合的 API:

<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;
            break;      // 找到一個就夠了,提前退出
        }
    }
    return issel;
}
</script>

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

getElementsByName() 無論匹配到一個還是多個,返回的永遠是 NodeList,所以 .length 始終可用,不必再寫分支判斷。示例裡把找到目標後 break 提前退出,也是個小優化——只需判斷「有沒有」時,找到第一個就可以收工。

順帶一提,原示例給每個 checkbox 用了相同的 id="enjoy[]",這是不符合規範的:id 在文檔中必須唯一。這裡已改為 enjoy1、enjoy2。

四、獲取所有勾選的值

實務中更常見的需求是把勾選的具體值取出來提交:

function getCheckedValues(name) {
    var nodes = document.querySelectorAll(
        'input[name="' + name + '"]:checked'
    );
    return Array.prototype.map.call(nodes, function(el){
        return el.value;
    });
}

// 用法
var picked = getCheckedValues('enjoy[]');   // ['1', '3']
console.log('共選了 ' + picked.length + ' 項');

屬性選擇器 :checked 是 CSS 原生支持的偽類,一行就能過濾出所有勾選項,比手寫循環清爽得多。

五、jQuery 版本

如果項目裡已經有 jQuery,代碼還能再短一些:

// 判斷是否有勾選
var hasChecked = $('input[name="enjoy[]"]').is(':checked');

// 取所有勾選值
var values = $('input[name="enjoy[]"]:checked')
                .map(function(){ return $(this).val(); })
                .get();

// 全選 / 取消全選
$('#checkAll').click(function(){
    $('input[name="enjoy[]"]').prop('checked', this.checked);
});

拿到勾選結果後,後續的校驗、禁用提交按鈕、拼接參數等操作就都是常規套路了。核心記住一點:處理同名 checkbox 時,永遠不要假設它一定是集合。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved