除了樣式,jQuery 另一大類常用操作是讀寫元素的屬性與內容。以下依「通用屬性」、「class」、「HTML 與文字」、「表單值」四組來整理。
| 方法 | 說明 |
|---|---|
attr(name) | 取得某屬性的值。 |
attr(name, value) | 設定某屬性的值。 |
attr(name, fn(index, value)) | 以函數回傳值作為屬性值。例如把第 (index+1) 個元素的 name 設為函數回傳值。 |
attr({name1:value1, …, nameN:valueN}) | 一次為同一元素設定多個屬性。 |
removeAttr(name) | 刪除元素的某個屬性。 |
這裡有個實務上很容易踩的坑:attr 與 prop 的分工。attr 操作的是 HTML 上的屬性字串,prop 操作的是 DOM 物件的當前狀態。像是 checked、selected、disabled 這類會隨使用者互動改變的狀態,從 jQuery 1.6 起就應該用 prop 讀寫;若用 attr,讀到的會是初始 HTML 裡寫死的值,而不是使用者目前的操作結果。
| 方法 | 說明 |
|---|---|
attr("class") / removeAttr("class") | class 本質上就是屬性,因此 attr() 完全可以處理。但實務上應優先用下面的專用方法。 |
addClass(value) | 為 class 屬性追加一個或多個值,多個值之間以空格分隔。 |
removeClass(value) | 移除一個或多個 class 值。不傳參數則清除全部。 |
toggleClass(value) | 切換 class 值:存在就移除,不存在就加上。可傳第二個布林參數強制指定狀態。 |
hasClass(value) | 判斷是否含有某 class 值,回傳布林值。比 attr('class') 字串比對可靠得多。 |
| 方法 | 說明 |
|---|---|
html() | 取得元素內部的 HTML 程式碼。 |
html(value) | 設定內部的 HTML 程式碼。 |
html(fn(index, value)) | 以函數回傳值作為要寫入的 HTML。 |
text() | 取得元素內部的文字內容。 |
text(value) | 設定內部的文字內容。 |
text(fn(index, value)) | 以函數回傳值作為要寫入的文字。 |
html() 與 text() 的關鍵差異有兩點。第一,text() 設定時會把內容當純文字處理,標籤會被轉義;html() 則會解析成真正的 DOM。第二,text(value) 不只是替換原有文字,連後代元素也會一併清除。
安全上請牢記:只要內容可能包含使用者輸入,就該用 text() 而非 html()。直接將未處理的使用者輸入塞進 html(),等於為 XSS 開了一扇門。
| 方法 | 說明 |
|---|---|
val() | 取得表單元素的 value 屬性值。 |
val(value) | 設定表單元素的 value。 |
val(fn(index, value)) | 以函數回傳值設定。 |
val([value1, …, valueN]) | 選定具有對應 value 的表單選項。對於 radio 以及未設定 multiple 的 select,參數中只有最後一個 value 有效。 |
val() 是表單操作的首選,因為它會自動處理不同元素的差異:對 input 取 value、對 textarea 取文字內容、對 select 取選中項的 value、對 checkbox / radio 組也能批次設定。讀取時若無選中項,select multiple 會回傳陣列,單選則回傳 null。