DIV CSS 佈局教程網

jQuery 設定 checkbox 選中卻沒反應:attr 與 prop 的差別
編輯:JavaScript綜合知識     

想讓核取方塊變成勾選狀態,寫了:

$("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,不要留模糊地帶。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved