這三個方法名字很像,行為卻有明確差異。混淆的代價通常是元素被放到錯誤的位置,或原來的元素憑空消失。
append():前面是要選的目標,後面是要插入的內容。
appendTo():前面是要插入的內容(必須是 jQuery 物件),後面是目標。
$('#a').append('content'); // 把 content 放進 #a
$('<div>content</div>').appendTo($('#a')); // 效果相同,方向相反
兩者結果一樣,差別只在語序。appendTo 前面一定要是 jQuery 物件,寫成字串會報錯,這是最常踩的坑。
選擇建議:當你心裡想的是「我要往這個容器裡加東西」時用 append;想的是「這個新元素要放到哪裡」時用 appendTo。讀起來順,程式碼就好維護。
element.appendChild(node);
在指定元素的最後一個子節點之後加入新節點。但這裡有個關鍵行為:如果傳入的 node 已經是文件中的既有元素,那不是複製,而是搬移。
也就是說 appendChild 的實際語意接近「移動一個元素」。若你想保留原位再複製一份,必須先 clone:
var copy = original.cloneNode(true); // true 表示連子節點一起複製 target.appendChild(copy);
忘了 clone 的結果就是:元素從原本的位置消失,出現在新位置。這在調整版面順序時常常是想要的行為,但在「多處顯示同一元素」的情境下就是 bug。
jQuery 的 append 在这一点上與原生相同——傳入既有元素時也是搬移而非複製。要複製請明確使用 .clone():
$('#target').append($('#source').clone());
在迴圈中反覆呼叫 append 會造成多次 DOM 操作與重排。大量插入時,建議先用字串組好整段再一次性 .html(str),或建立文件片段後一次掛上。