接到一個再簡單不過的需求:做全選。一個總 checkbox,勾了它底下全部勾上,取消就全部取消。兩分鐘應該能寫完的東西,結果卡了整個下午。
問題出在这一行:
. 代碼如下:
alert($("#checkbox_all").attr("checked")); // 永遠是 undefined換 Chrome、換 IE、換 Firefox,行為一模一樣。既然不是瀏覽器的問題,那就只能是 jQuery 的問題了。
從 jQuery 1.6 開始,attr("checked") 回傳的是元素在 HTML 裡最初的狀態,而不是目前狀態。也就是說:
· 如果這個 checkbox 在頁面載入完成時是勾選的,attr("checked") 永遠回傳 "checked",不管你後來怎麼點。
· 如果載入時沒勾,那它就永遠回傳 undefined,即使你已經點了十次。
這個設計其實是有道理的——HTML 規範裡,checked 這個 content attribute 代表的是「預設值」,而使用者在頁面上做的操作改變的是 checked property(DOM 屬性),兩者本來就是不同東西。jQuery 只是終於把這個區別如實反映出來而已。
. 代碼如下:
alert($("#checkbox_all").prop("checked")); // true 或 falseprop() 讀的是 DOM property,會反映目前真實狀態。於是全選就變成:
. 代碼如下:
// #check_all 是全選總框,.check_children 是各子項或者寫得明確一點:
. 代碼如下:
$("#check_all").change(function(){我偏好第一種寫法,程式碼越少越好——write less, do more。而且用 change 而不是 click 也更恰當,因為 change 語意上就是「值改變了」,用鍵盤空格鍵操作時也會觸發,click 則不保證。
· attr("checked") → 初始 HTML 狀態,回傳 "checked" 或 undefined
· prop("checked") → 目前狀態,回傳 true/false(讀取與設定都該用它)
· is(":checked") → 目前是否勾選,回傳 boolean,寫在 if 條件裡可讀性最好
同樣的規則適用於 selected、disabled、readonly 這些「會變動的 boolean 屬性」,一律用 prop()。相對地,id、class、title、href 這種真正寫在 HTML 標籤上的,用 attr() 才對。
全選還有一個反向需求:使用者手動把子項全部取消時,總 checkbox 應該自動變成未勾選。這段邏輯要另外寫:
. 代碼如下:
$('.check_children').change(function(){最後那行 indeterminate 是很有用但常被漏掉的功能:它會讓總 checkbox 顯示成「半選」的橫槓狀態(部分勾選),對使用者來說資訊量比單純的勾/不勾清楚得多。