DIV CSS 佈局教程網

jQuery 全選失效?attr() 與 prop() 之爭完整解析
編輯:JQuery特效代碼     

做專案時遇到一個經典問題:用 jQuery 控制核取方塊全選,第一次點擊完全正常,第二次卻選不起來了。請教前輩後才搞懂原因,這裡把過程與分析記錄下來。

重現問題

<form>
  你愛好的運動是?<input type="checkbox" id="CheckedAll" />全選/全不選<br />
  <input type="checkbox" name="items" value="足球" />足球
  <input type="checkbox" name="items" value="籃球" />籃球
  <input type="checkbox" name="items" value="羽毛球" />羽毛球
  <input type="checkbox" name="items" value="乒乓球" />乒乓球
  <br />
  <input type="button" id="send" value="提 交" />
</form>

$("#CheckedAll").click(function(){
  if($(this).is(":checked")){
    $("[name=items]:checkbox").attr("checked", true);
  }else{
    $("[name=items]:checkbox").attr("checked", false);
  }
});

第一次執行沒問題,第二次就失效了。

解法:把 attr() 換成 prop()

$("#CheckedAll").click(function(){
  if($(this).is(":checked")){
    $("[name=items]:checkbox").prop("checked", true);
  }else{
    $("[name=items]:checkbox").prop("checked", false);
  }
});

為什麼?attr 與 prop 的差別

jQuery 更新到 1.6.1 時新增了 .prop() 方法。單看字面,properties 與 attributes 中文都叫「屬性」,很容易混淆,但它們的角色其實不同。

1.6 版本移除了 attributes 與 properties 之間「模稜兩可」的處理方式,這在社群中造成一陣混亂,因為 1.6 之前所有版本都用同一個 .attr() 同時處理兩者。舊的 .attr() 存在若干難以維護的 bug,因此 1.6.1 更新了 Attributes 模組並修掉這些問題。好消息是:從 1.5.2 升級到 1.6.1,你不必修改任何既有的 attribute 程式碼。

特別是 boolean 屬性(checked、selected、readonly、disabled),1.6.1 的行為與 1.6 之前一致,也就是說下面這些寫法照樣能跑:

$(":checkbox").attr("checked", true);
$("option").attr("selected", true);
$("input").attr("readonly", true);
$("input").attr("disabled", true);

甚至是條件判斷:

if( $(":checkbox").attr("checked") ){ /* 做點什麼 */ }

在 1.6.1 中也不需要為了維持原本的預期結果而做任何修改。

然而在 1.6 中,下面這種寫法會失效:

$(":checkbox").attr("checked", true);

原因是:attribute 對應的是 HTML 標記中寫死的那個值,例如 <input type="checkbox" checked="checked">。boolean attribute 只代表「初始值/預設值」,它在頁面載入時就被設定好,日後無論使用者有沒有勾選都不會改變。真正記錄「目前狀態」的是 property —— 當使用者點擊 checkbox 或選擇某個 option 時,property 會即時更新,而 attribute 仍停留在初始值。所以你在 1.6 中用 attr() 設定的其實是初始值,checkbox 當然不會被勾起來。

等價寫法可以對照來看:

$(":checkbox").get(0).checked = true;
// 等同於 $(":checkbox:first").prop("checked", true);

另外,window 與 document 上呼叫 .attr() 在 1.6 中無法運作,因為它們沒有 attribute,只有 property(如 location、readyState),必須改用 .prop() 或原生寫法。1.6.1 則會自動把這種情況轉為 .prop(),不再拋出錯誤。

1.6.1 支援以 .attr() 動態取得/設定 boolean 屬性的完整清單如下(多數為 HTML5 新增):

autofocus, autoplay, async, checked, controls, defer, disabled, hidden, loop, multiple, open, readonly, required, scoped, selected

取值/設值該用哪個方法的優先順序,可以這樣記:

· boolean 屬性/property,以及 HTML 中不存在者(如 window.location),用 .prop()。
· 其餘一般 attribute,繼續用 .attr() 即可。
· 表單元素的 value 不該用 attr() 或 prop() 取值設值,請改用 .val()。

即使不改用 .prop(),上述案例在 1.6.1 仍可運行,但仍建議統一改用 .prop(),語意更準確,也能避開未來版本的兼容性風險。

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