做後台列表頁時,表頭那個「全選」核取方塊幾乎是標配。功能聽起來簡單,但如果你寫的是 attr("checked","checked"),很可能會遇到一種很詭異的現象:全選能用、取消全選看起來也能用,可是後面取值那段卻永遠拿不到資料,甚至後續的其他操作也一起失效。
最初我寫的是這三行:
// 全選
$(":checkbox").attr("checked","checked");
// 取消全選
$(":checkbox").removeAttr("checked");
// 取得所有被勾選的項目
$(":checked[checked='checked']")
問題就出在最後一行。attr() 操作的是 HTML 標籤上的屬性(attribute),而核取方塊真正被勾上、被取消,改變的是 DOM 元素上的「屬性狀態」(property)。兩者並不是同一份資料,用 attr 寫入的值和瀏覽器實際的勾選狀態會逐漸脫節,選擇器自然也撈不到東西。
遇到這種情況不必糾結太久,換一套 API 就好——這也是腳本語言常見的兩面性:寫起來很自由,但語意上的細微差異得自己摸清楚。
// 全選
$(":checkbox").prop("checked", true);
// 取消全選
$(":checkbox").prop("checked", false);
// 取得所有被勾選的項目
$(":checkbox:checked")
prop() 直接讀寫元素自身的狀態,寫入後瀏覽器的勾選方塊會即時反映,取值時用:checked 過濾也一致,三個動作終於對得上。
反選(也叫半選、交叉選擇)的思路是遍歷每一個核取方塊,把當前狀態取反:
$(":checkbox").each(function(){
if ($(this).prop("checked")) {
$(this).prop("checked", false);
} else {
$(this).prop("checked", true);
}
});
也可以寫得更精簡:
$(":checkbox").each(function(){
$(this).prop("checked", !$(this).prop("checked"));
});
如果頁面上核取方塊很多,建議用更具體的選擇器(例如 $("#userTable :checkbox"))縮小範圍,避免誤傷頁面上的搜尋條件、單選鈕等其他表單元素。另外,全選核取方塊本身的「半選中視覺狀態」可以用 .prop("indeterminate", true) 來處理,讓使用者一眼看出「只選了一部分」。