jQuery 1.6 新增了 prop() 方法,官方說明只有一句:取得匹配元素集中第一個元素的屬性值。聽起來和 attr() 沒兩樣,實際上兩者針對的是不同東西。
各家瀏覽器對布林屬性的寫法不一致:有的只要寫 disabled 或 checked 就算生效,有的必須寫成 disabled="disabled"、checked="checked"。
於是如果用 attr("checked") 去取核取方塊的狀態,選取時得到字串 "checked",未選取時得到 undefined——兩者都不是我們真正想要的布林值,拿來寫條件判斷很容易出錯。
改用 prop() 之後,不管選取與否都會統一回傳 true 或 false:
$("#myCheckbox").prop("checked"); // true / false
$("#myCheckbox").prop("checked", true); // 設定為勾選
差別在於:attr() 操作的是 HTML 上寫的那個屬性(attribute),也就是元素被解析時的初始狀態;prop() 操作的是 DOM 物件上的當前特性(property),也就是使用互動後的即時狀態。
prop()。prop()。attr()。專案升級 jQuery 版本時,這是最容易出問題的一處,值得逐頁檢查。
下表列出各屬性/特性該用哪個方法(勾選表示適用):
attr():accesskey、align、class、contenteditable、draggable、href、id、label、rel、src、tabindex、title、typeasync、autofocus、checked、multiple、readOnly、selectedlocation(即 window.location):兩者皆可,但實際上應直接操作 window.locationwidth:若需要覆蓋 .width() 時才用 attr()不用 jQuery 時,這兩層對應到原生的 getAttribute()/setAttribute() 與 element.checked 這類屬性存取。實務上直接寫 checkbox.checked 最直觀。另外要提醒:attr() 與 prop() 在 jQuery 3 之後,對 checked 的行為已有些調整,若從舊版升級,請務必重測表單相關功能。