jQuery 的插入方法分成兩組,各四個:一組是「把內容放進目標」,另一組是「把自己放到目標」。初學時最容易搞混的就是這兩組的方向相反。以下逐一整理。
效果等同對所有指定元素執行 appendChild。
HTML:<p>I would like to say: </p>
$("p").append("<b>Hello</b>");
結果:<p>I would like to say: <b>Hello</b></p>
它是 $(A).append(B) 的反向寫法:不是把 B 放進 A,而是把 A 放進 B。
HTML:<p>I would like to say: </p><div id="foo"></div>
$("p").appendTo("#foo");
結果:<div id="foo"><p>I would like to say: </p></div>
要往所有符合元素的最前面插入內容,這是最佳方式。
$("p").prepend("<b>Hello</b>");
結果:<b>Hello</b><p>I would like to say: </p>
也可以傳入 DOM 元素或 jQuery 物件:
HTML:
<p>I would like to say: </p>
<p>I would like to say: </p>
<b class="foo">Hello</b>
<b class="foo">Good Bye</b>
$("p").prepend( $(".foo")[0] );
結果:
<p><b class="foo">Hello</b>I would like to say: </p>
<p><b class="foo">Hello</b>I would like to say: </p>
<b class="foo">Hello</b>
<b class="foo">Good Bye</b>
傳入 jQuery 物件時:$("p").prepend( $("b") ); 會把 b 放到每個 p 的開頭。
$("p").prependTo("#foo");
結果:<div id="foo"><p>I would like to say: </p></div>
$("p").after("<b>Hello</b>");
$("p").after( $("#foo")[0] ); // 傳 DOM 元素
$("p").after( $("b") ); // 傳 jQuery 物件
結果:<p>I would like to say: </p><b>Hello</b>
$("p").before("<b>Hello</b>");
$("p").before( $("#foo")[0] );
$("p").before( $("b") );
結果:<b>Hello</b><p>I would like to say: </p>
$("p").insertAfter("#foo"); // 等同 $("#foo").after("p")
結果:<div id="foo">Hello</div><p>I would like to say: </p>
$("p").insertBefore("#foo"); // 等同 $("#foo").before("p")
結果:<p>I would like to say: </p><div id="foo">Hello</div>
把這八個方法排在一起,規律就很清楚——帶 To 的那四個,主詞與受詞是顛倒的:
A.append(B) = B.appendTo(A):B 進到 A 裡,放最後。A.prepend(B) = B.prependTo(A):B 進到 A 裡,放最前。A.before(B) = B.insertBefore(A):B 放在 A 前面(同層)。A.after(B) = B.insertAfter(A):B 放在 A 後面(同層)。記憶方式:append / prepend 是「放進去」(內部),after / before 是「放在旁邊」(同層);而 appendTo / prependTo / insertBefore / insertAfter 只是把同一件事反過來說,選擇哪一種純粹看哪一邊是你手上的 jQuery 物件。
實務上還有個差異值得注意:當來源符合多個元素、目標只有一個時,元素會被移動過去;若目標符合多個元素,jQuery 會保留原元素並複製一份到各個目標位置。