這陣子在使用 jQuery 時,想實作一個簡單的核取方塊動態全選/全不選功能,結果測試時發現 attr('checked','checked') 與 attr('checked',true) 都不管用——要嘛第一次成功、第二次呼叫就沒反應,要嘛完全不起作用。到底是什麼原因呢?
網路上關於 jQuery checkbox 動態選擇的文章,多半都寫成這樣:
$('input[type=checkbox]').attr('checked','checked'); // 全選,設定屬性
$('input[type=checkbox]').attr('checked',true); // 全選,布林值形式
$('input[type=checkbox]').attr('checked',false); // 取消,布林值形式
$('input[type=checkbox]').removeAttr('checked'); // 取消,刪除屬性
然而實際測試卻發現,選一次全選、再呼叫一次反選、接著再全選就失效了。難道是 removeAttr 的關係?還是版本的問題?其實這些都不是根本理由,關鍵在於沒有選對方法。
到官方網站搜尋 checkbox 相關說明後,發現一組對照範例:
$('obj').attr('checked',true);
$('obj').prop('checked',true);
$('obj').attr('checked',false);
$('obj').prop('checked',false);
答案很清楚:操作核取方塊的勾選狀態時,應該使用 prop() 而非 attr(),一切就正常了。
原因在於,checked 屬於元素的「當前狀態屬性」(property),而非單純的 HTML 屬性(attribute)。從 jQuery 1.6 開始,官方就建議:凡是涉及 dynamically 變化的狀態(如 checked、selected、disabled),都應改用 prop() 來讀取或設定,才能確保行為與實際狀態一致。