想讓核取方塊變成勾選狀態,寫了:
$("input").attr("checked", "checked");
結果用 Chrome 開發者工具一看,DOM 上確實有 checked="checked",畫面卻仍是未勾選。這不是瀏覽器的問題,而是用錯了 API。
$("input").prop("checked", true);
attribute 是 HTML 標籤上寫死的初始值,property 是元素物件在執行階段的當前狀態。核取方塊的勾選狀態屬於後者。jQuery 1.6 之前,.attr() 在取某些值時會回傳 property,造成兩者界線模糊;從 1.6 開始,.prop() 專責讀寫 property,.attr() 專責讀寫 attribute,混用就會出問題。
以下這些都應該改用 .prop():selectedIndex、tagName、nodeName、nodeType、ownerDocument、defaultChecked、defaultSelected。它們並沒有對應的 attribute,只有 property。
以 <input type="checkbox" checked="checked" /> 為例,假設對應的 JS 變數是 elem:
elem.checked // true (Boolean) 會改變核取方塊狀態
$(elem).prop("checked") // true (Boolean) 會改變核取方塊狀態
elem.getAttribute("checked") // "checked" (String) 不改變當前狀態
$(elem).attr("checked") (1.6) // "checked" (String) 不改變當前狀態
$(elem).attr("checked") (1.6.1+) // "checked" (String) 會同步更新 property
$(elem).attr("checked") (pre-1.6) // true (Boolean) 會改變狀態
依 W3C 的表單規範,checked 是布林屬性:只要這個 attribute 存在,不論有沒有值、甚至值是空字串,對應的 property 就是 true。這也解釋了為什麼用 attr 去「設定」很容易得到非預期的結果。
if (elem.checked) { ... }
if ($(elem).prop("checked")) { ... }
if ($(elem).is(":checked")) { ... }
// 全選
$("input[type=checkbox]").prop("checked", true);
// 全不選
$("input[type=checkbox]").prop("checked", false);
// 取得所有被勾選的值
var values = $("input[type=checkbox]:checked").map(function () {
return $(this).val();
}).get();
補充一點:從 jQuery 1.6.1 起,.attr() 除了回傳屬性值也會更新 property,所以為了向後相容,某些布林屬性確實可以繼續用 attr 操作。但既然 prop 語意明確,新程式一律建議用 prop,不要留模糊地帶。