「點一下全選,下方所有項目跟著打勾」聽起來是再基本不過的功能,實作時卻很容易卡在奇怪的是:程式邏輯明明沒錯,勾選狀態就是不動。問題幾乎都出在同一個地方——用 attr 去操作 checked。
直覺的寫法通常是這樣:監聽全選按鈕的點擊,判斷它是否被勾選,再對表格裡每個 input 逐一設定 checked 屬性。但在 jQuery 1.6 之後,$('#chk').attr('checked', true) 對於「已經存在於 DOM 上」的元素並不會如預期切換勾選狀態,因為 checked 反映的是元素的「目前狀態」而非「初始屬性」。
官方 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 屬性顯示半選橫線,操作起來會清楚很多。