DIV CSS 佈局教程網

jQuery 全選復選框踩坑筆記:為什麼一定要用 prop 而不是 attr
編輯:JQuery特效代碼     

「點一下全選,下方所有項目跟著打勾」聽起來是再基本不過的功能,實作時卻很容易卡在奇怪的是:程式邏輯明明沒錯,勾選狀態就是不動。問題幾乎都出在同一個地方——用 attr 去操作 checked。

問題描述

直覺的寫法通常是這樣:監聽全選按鈕的點擊,判斷它是否被勾選,再對表格裡每個 input 逐一設定 checked 屬性。但在 jQuery 1.6 之後,$('#chk').attr('checked', true) 對於「已經存在於 DOM 上」的元素並不會如預期切換勾選狀態,因為 checked 反映的是元素的「目前狀態」而非「初始屬性」。

關鍵差異:attr 與 prop

官方 API 對此早有說明。attr 讀寫的是 HTML 標籤上的屬性,反映的是頁面載入時的初始值;prop 讀寫的是 DOM 物件的 JavaScript 屬性,反映的是使用者的即時操作結果。核取方塊、下拉選單、輸入框的 disabled 都屬於後者,必須用 prop。

官方文件裡有一個很經典的對照範例:同一個核取方塊,用 .is(":checked") 判斷時會得到使用者操作後的真實狀態,而 .attr("checked") 可能還是初始值。把這個範例跑一遍,差異就很直觀了,api 網址是 https://api.jquery.com/prop/。

修正後的程式碼

$("#main-manage").on('click', "#selectAll", function(event) {
    $("#xunTable").find('input').not(":disabled").each(function(index, el) {
        if ($("#selectAll").is(":checked")) {
            $(this).prop('checked', true);
        } else {
            $(this).prop('checked', false);
            $(this).removeAttr('checked');
        }
    });
});

幾個改寫重點:判斷全選鈕狀態時用 .is(":checked") 而非讀 attr;設定勾選用 prop('checked', true/false);取消時順手 removeAttr('checked') 清掉標籤上的初始屬性,避免某些舊版瀏覽器殘留狀態造成下次載入時的誤判。另外用 .not(":disabled") 排除停用項,這是實務上很常被忽略的一環。

事件綁定改用 on() 的委派形式($(document).on('click', '#selectAll', ...) 或容器委派),是因為全選鈕若是動態插入的,直接 bind 或 click 綁不上;委派寫法對後續新增的節點也有效。

順帶一提

如果列表是透過 Ajax 動態載入,還要多處理「部分勾選」狀態:當子項被逐一勾滿時自動把全選鈕設為 true,取消任一項時設回 false,並可用 indeterminate 屬性顯示半選橫線,操作起來會清楚很多。

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