DOM 操作是 jQuery 最初打響名號的能力。以下把常用方法依用途分成五組,格式為 $(selector).方法,其中 $(selector) 代表當前選定元素。
一、移動元素
| 方法 | 說明 |
append($(selector)) | 把內容追加到當前元素的內部(尾端)。 |
appendTo($(selector)) | 把當前元素追加到某元素內部。由於會實際移動元素,jQuery 物件已被改變,可用 end() 還原。 |
prepend($(selector)) | 把內容插入到當前元素的內部(首端)。 |
prependTo($(selector)) | 把當前元素前置插入到某元素內部。類似 appendTo(),會改變物件。 |
after($(selector)) | 把內容插入到當前元素之後(同層)。 |
insertAfter($(selector)) | 把當前元素插入到某元素之後。同樣會改變物件。 |
before($(selector)) | 把內容插入到當前元素之前(同層)。 |
insertBefore($(selector)) | 把當前元素插入到某元素之前。同樣會改變物件。 |
每組都有「A 型」與「B 型」兩個版本,差別在於第一人稱是誰:append 是「我把內容放進去」,appendTo 是「我被放進去」。這也解釋了為什麼 B 型會改變 jQuery 物件——它操作的是被插入的那個元素,而不是原本選到的目標。
二、添加元素
| 方法 | 說明 |
$(html) | 根據 HTML 字串建立新的 jQuery 物件,再利用移動方法插入文件。 |
clone() | 複製當前選定元素並回傳副本的 jQuery 物件,同樣需搭配移動方法使用。clone() 指向副本,等同改變了 jQuery 物件,可用一次 end() 還原到選定元素;二次 end() |
補充一點:clone() 預設不複製事件綁定,傳入 clone(true) 才會連事件一起複製。這是實務上很常忘記的差異。
三、替換元素
| 方法 | 說明 |
replaceWith($(selector)) / replaceWith($(html)) | 用頁面上既有元素或新元素,替換當前選定元素。 |
replaceAll($(selector)) / replaceAll($(html)) | 用當前選定元素去替換某元素,目標可以是既有元素或新元素。同樣會視需要複製副本,因而改變 jQuery 物件。 |
四、包裹元素
| 方法 | 說明 |
wrap($(selector)) / wrap($(html)) | 用既有元素或新元素,分別包裹每一個當前選定元素。 |
unwrap() | 移除當前元素的父元素,但父元素內部的文字與其他內容仍保留。 |
wrapAll($(selector)) | 用一個包裹元素把所有選定元素包在同一層,這點不同於 wrap() 的逐一包裹。 |
wrapInner($(selector)) | 分別包裹每個選定元素「內部」的內容,而非元素本身。 |
五、刪除與清空元素
| 方法 | 說明 |
remove() | 刪除當前元素,連同其文字內容與後代元素,綁定的事件與快取數據也一併清除。 |
detach() | 同樣把元素從文件樹移開,但保留事件與數據,適合稍後再插回畫面的場景(例如拖曳排序)。 |
empty() | 清空當前元素的內容(文字與後代元素),但保留元素本身。 |
remove() 與 detach() 的選擇很實際:只是暫時移開、之後還要放回,就用 detach;確定丟掉,就用 remove,讓 jQuery 能把記憶體與事件綁定一併釋放,避免不必要的佔用。