checkbox 全選是後台管理系統的標配功能,也是最容易出現「第一次好用、第二次失灵」的場景。本文記錄一次真實排查過程與根因。
項目中使用 jQuery,判斷勾選狀態一直寫的是:
// 檢測選中的 checkbox
$('input[name="abc"]:checked').each(function () {
// ...
});
全選與取消全選則這樣寫:
$('input[name="abc"]').attr('checked', true);
$('input[name="abc"]').attr('checked', false);
問題來了:頁面首次加載時點全選有效,取消也有效;但反覆點擊幾次之後,勾選狀態不再跟著變。查看源代碼,checked 屬性確實已經被寫上了,畫面卻沒有反應。
這是 jQuery 1.6 引入 prop() 的核心原因。二者的分工是:
attr() 操作的是元素的 HTML 屬性,也就是初始狀態、寫死在標籤上的值。checkbox 的 checked 一旦渲染完成,這個屬性並不會隨用戶操作改變。
prop() 操作的是元素的 DOM 屬性(property),反映運行時的真實狀態。checked、selected、disabled 這類「動態狀態」必須用 prop。
所以 attr 看起來「有時生效」,實際上生效的只是首次渲染時的默認值,後續狀態早已與 DOM 屬性脫節。
$('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 操作相關彙總資料。