DIV CSS 佈局教程網

jQuery 全選失效排查:attr 與 prop 在 checkbox 上的關鍵差異
編輯:JQuery入門技巧     

checkbox 全選是後台管理系統的標配功能,也是最容易出現「第一次好用、第二次失灵」的場景。本文記錄一次真實排查過程與根因。

現象

項目中使用 jQuery,判斷勾選狀態一直寫的是:

// 檢測選中的 checkbox
$('input[name="abc"]:checked').each(function () {
    // ...
});

全選與取消全選則這樣寫:

$('input[name="abc"]').attr('checked', true);
$('input[name="abc"]').attr('checked', false);

問題來了:頁面首次加載時點全選有效,取消也有效;但反覆點擊幾次之後,勾選狀態不再跟著變。查看源代碼,checked 屬性確實已經被寫上了,畫面卻沒有反應。

根因:attr 改的是 HTML 屬性,不是 DOM 屬性

這是 jQuery 1.6 引入 prop() 的核心原因。二者的分工是:

attr() 操作的是元素的 HTML 屬性,也就是初始狀態、寫死在標籤上的值。checkbox 的 checked 一旦渲染完成,這個屬性並不會隨用戶操作改變。

prop() 操作的是元素的 DOM 屬性(property),反映運行時的真實狀態。checked、selected、disabled 這類「動態狀態」必須用 prop。

所以 attr 看起來「有時生效」,實際上生效的只是首次渲染時的默認值,後續狀態早已與 DOM 屬性脫節。

解決:改用 prop()

$('input[name="abc"]').prop('checked', true);    // 全選
$('input[name="abc"]').prop('checked', false);   // 取消全選

另一個坑:如何知道哪個元素被點擊了

換成 prop 之後,取消全選的場景下需要逐項判斷。如果 name 寫成了 abc[] 這種數組形式,選擇器也要跟著調整:

// 寫法一:直接篩選已勾選的
$('input[name="abc[]"]:checked').each(function (i) {
    // $(this) 即為選中元素
});

// 寫法二:逐項判斷
$('input[name="abc[]"]').each(function (i) {
    var flag = $(this).prop('checked');
    if (flag) {
        // $(this) 即為選中元素
    }
});

兩種寫法效果相同,第一種更簡潔;第二種在需要同時處理勾選與未勾選元素時更靈活。

反選怎麼寫

$('input[name="abc"]').each(function () {
    $(this).prop('checked', !$(this).prop('checked'));
});

注意這裡不能用 !$(this).attr("checked"),因為 attr 返回的是字符串 "checked" 或 undefined,取反的結果與預期不符。

選型口訣

凡是有「默認值」與「當前值」之分的屬性,一律用 prop:checked、selected、disabled。凡是寫死在標籤上、運行時不變的,如 id、class、href、data-*,用 attr。判斷是否存在某個 class 時,更推薦直接用 hasClass(),語意最清晰。

更多 jQuery 表單操作技巧,可參考 jQuery form 操作相關彙總資料。

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