「全選」功能寫好之後,第一次點擊正常運作,第二次卻沒反應——這幾乎每個人都遇過。問題不在你的邏輯,而在於用錯了 API。
在 jQuery 1.6 之後,.attr("checked") 回傳的是 HTML 標籤上那個屬性的「初始設定值」,它代表的是「這個核取方塊預設是否被勾選」,並不會隨使用者操作而改變。也就是說,使用者把方塊取消勾選之後,.attr("checked") 依然可能回傳 checked。
真正反映「當前是否被勾選」的是 DOM 的 property(屬性狀態),對應的 API 是 .prop():
// 讀取目前是否勾選
if ($("#box-all").prop("checked")) {
// 已勾選
}
// 設定勾選狀態
$("#box-all").prop("checked", true);
jQuery 1.6.1 之後,.attr() 在回傳屬性值的同時也會順手更新 property,這讓部分舊程式剛好還能跑,但這只是相容性上的權宜之計,不可依賴。凡是 checked、selected、disabled 這類布林屬性,一律該用 prop()。
<script type="text/javascript" src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script type="text/javascript">
$(function(){
$('.ckAll').click(function(){
$(".box-items").each(function(){
$(this).prop("checked", !!$(".box-all").prop("checked"));
});
});
});
</script>
<div>
<label class="ckAll">
<input class="box-all" type="checkbox" />
<span>全選</span>
</label>
<input class="box-items" type="checkbox" />
<input class="box-items" type="checkbox" />
<input class="box-items" type="checkbox" />
<input class="box-items" type="checkbox" />
<input class="box-items" type="checkbox" />
</div>
這裡的 !! 用來把 prop() 的回傳值強制轉成純布林值,避免在比較時出現意料之外的型別轉換。而 .each() 迴圈其實可以簡化成一行,因為 prop() 本身就會作用於集合中的所有元素:
$(".box-items").prop("checked", $(".box-all").prop("checked"));
實用的全選功能通常還要處理「子項全被勾選時,全選框自動亮起」:
$(".box-items").on("change", function(){
var total = $(".box-items").length;
var checked = $(".box-items:checked").length;
$(".box-all").prop("checked", total === checked);
});
記住這條規則就不會再犯:屬性(attribute)描述 HTML 怎麼寫,property 描述元素現在是什麼狀態。涉及使用者互動後的狀態,一律走 prop()。