在 jQuery 的眾多能力之中,對 DOM 節點進行包裝、替換、移除與複製,可說是日常開發裡最常被用到的操作。這一篇筆記整理了这幾類方法的核心用法與背後的原理,並附上對照範例,方便日後查閱。
wrap() 的作用是把每一個被選到的元素,分別用指定的結構包起來。這種做法特別適合在不破壞原有語義的前提下,往文件裡注入額外的結構。
它的運作方式是:先根據傳入的 HTML 標記動態產生一個元素,再找出這段結構裡最外層的祖先節點,並用它作為真正的包裹外殼。需要注意的是,如果標記本身帶有文字內容,這個方法就無法正常運作;因此若需要加入文字,應在包裹完成之後再補上。
回傳值:jQuery 物件
參數:
html (String):用於動態產生元素並包裹目標的 HTML 標記字串elem (Element):用於包裹目標的既有 DOM 元素範例一,用一個新建的 div 把所有段落包起來:
<p>Test Paragraph.</p>
$("p").wrap("<div class='wrap'></div>");
結果:
<div class="wrap"><p>Test Paragraph.</p></div>
範例二,用 id 為 content 的 div 去包裹段落(此處以 DOM 元素傳入):
$("p").wrap(document.getElementById('content'));
wrapAll() 與 wrap() 最大的差別在於:它會把選到的所有元素,一起放進同一個外層元素裡,而不是每個元素各包一次。這在需要把一整組元素收攏到單一容器中時非常方便。
回傳值:jQuery 物件
參數:
html (String):用於動態產生包裹元素的 HTML 標記字串elem (Element):用於包裹目標的既有 DOM 元素範例,用一個 div 把所有段落收進同一層:
<p>Hello</p><p>cruel</p><p>World</p>
$("p").wrapAll("<div></div>");
結果:
<div><p>Hello</p><p>cruel</p><p>World</p></div>
若改用 DOM 元素,寫法為 $("p").wrapAll(document.createElement("div"));,效果相同。
前面兩者包裹的是元素本身,而 wrapInner() 包裹的則是每個符合元素「內部」的子內容(包含文字節點)。常見用途像是替段落裡的文字加上一層標籤。
回傳值:jQuery 物件
參數:
html (String):用於動態產生包裹結構的 HTML 標記字串elem (Element):用於包裹的既有 DOM 元素範例,把每段內容用粗體標籤包起來:
$("p").wrapInner("<b></b>");
結果:
<p><b>Hello</b></p><p><b>cruel</b></p><p><b>World</b></p>
等價的 DOM 寫法為 $("p").wrapInner(document.createElement("b"));。
replaceWith() 會用指定的 HTML 或 DOM 元素,把每一個符合的目標換掉;而 replaceAll() 則是反過來思考——以「符合的元素」去替換掉「選擇器所選到的元素」。兩者方向相反而結果相近。
回傳值:jQuery 物件
參數:
content (String, Element, jQuery):用來替換目標的內容selector (選擇器):用來找出待替換元素的選擇器
// 用粗體標記替換所有段落
$("p").replaceWith("<b>Paragraph. </b>");
// 以符合的元素去替換段落
$("<b>Paragraph. </b>").replaceAll("p");
empty() 只清空元素「內部」的所有子節點,元素本身仍留在文件裡;而 remove() 則是把符合的元素整個從 DOM 中移除。特別的是,remove() 不會把這些元素從 jQuery 物件中刪掉,因此日後仍能取回再利用,也可以搭配可選的表達式做進一步篩選。
回傳值:jQuery 物件
參數:expr (String)(可選)用來篩選元素的 jQuery 表達式。
// 清空段落的子內容
$("p").empty();
// 從 DOM 移除所有段落
$("p").remove();
// 只移除帶有 hello 類別的段落
$("p").remove(".hello");
clone() 會複製符合的 DOM 元素並選取這些副本,很適合用來把元素的複本放到文件的其他位置。若加上參數 true,則連元素上的事件處理一併複製過去。
回傳值:jQuery 物件
參數:true (Boolean):設為 true 時,會複製元素的所有事件處理。
// 複製所有 b 元素並前置到段落中
$("b").clone().prependTo("p");
// 建立一個能複製自己、且副本也具備同樣功能的按鈕
$("button").click(function(){
$(this).clone(true).insertAfter(this);
});
第二個範例的巧妙之處在於 clone(true) 把點擊事件一起複製,於是每一次點擊產生的副本,都能繼續複製自己,形成連鎖效果。