jQuery 提供了好幾組「插入」方法,名字相近、行為卻各異,初學時最容易搞混。關鍵在於兩個維度:插在哪裡(元素內部還是元素外部),以及放在前還是放在後。另外每組方法都有一個「主動式」與「被動式」的孿生兄弟,兩者效果相同,差別只在回傳值。
A.after(B) 是把 B 放到 A 的後面,兩者是兄弟關係;A.before(B) 則是把 B 放到 A 的前面。也就是說,被插入的內容並不會成為 A 的子元素。
這兩個方法的主詞與上一組相反。A.insertAfter(B) 的意思是「把 A 搬到 B 後面」,A.insertBefore(B) 則是把 A 搬到 B 前面。它們常用來重新排列頁面上已存在的元素。
舉例來說,原本結構是 <span>CC</span><p>HELLO</p>,執行 $("span").insertAfter($("p")) 之後就變成 <p>HELLO</p><span>CC</span>,兩者位置對調。
A.append(B) 是把 B 塞進 A 裡面,成為 A 的最後一個子節點。反過來,A.appendTo(B) 是把 A 塞進 B 裡面,同樣放在 B 的最後。
與 append 系列唯一的差別是位置:內容會成為第一個子節點,排在所有既有子元素之前。
append():在被選元素的結尾插入內容。
prepend():在被選元素的開頭插入內容。
after():在被選元素之後插入內容。
before():在被選元素之前插入內容。
<script type="text/javascript" src="https://common.jb51.net/jslib/jquery/jquery.min.js"></script>
<div class="testdiv">
<ul>
<li>第一個li標簽</li>
</ul>
</div>
<script>
//append:變成 ul 的最後一個子元素
$('.testdiv ul').append('<li>append 插入的li</li>');
//prepend:變成 ul 的第一個子元素
$('.testdiv ul').prepend('<li>prepend 插入的li</li>');
//after:插在 ul 後方,成為 ul 的兄弟
$('.testdiv ul').after('<li>after 插入的li</li>');
//before:插在 ul 前方,同樣是兄弟
$('.testdiv ul').before('<li>before 插入的li</li>');
</script>
執行結果如下:

對應的 HTML 結構變化:

$('#demo').append('<a/>'); // 回傳 $('#demo')
$('<a/>').appendTo($('#demo')); // 回傳 $('a')
也就是說 appendTo 系列回傳的是被搬動的那個元素,而 append 系列回傳的是原本的容器。若後面還要接鏈式呼叫,這個差異會直接影響你能對誰操作,值得留意。
如果想理解這些方法在瀏覽器端究竟做了什麼,可以參考原生 API insertAdjacentHTML / insertAdjacentText / insertAdjacentElement,它們正好對應 beforebegin、afterbegin、beforeend、afterend 四個插入位置。
function _insert(parent, position, any, index) {
if ($.isFunction(any)) {
any = any.call(parent);
}
if ($.isString(any)) {
if (regTag.test(any)) {
parent.insertAdjacentHTML(position, any);
} else {
parent.insertAdjacentText(position, any);
}
} else if ($.isNumber(any)) {
parent.insertAdjacentText(position, any);
} else if ($.isElement(any)) {
parent.insertAdjacentElement(position, index > 0 ? any.cloneNode(!0) : any);
} else if (_isYquery(any)) {
any.each(function() {
_insert(parent, position, this);
});
}
}
有了這個底層函式,四個方法就只是四種 position 參數的差別:
append: function(any){ return this.each(function(index){ _insert(this, 'beforeend', any, index); }); },
prepend: function(any){ return this.each(function(index){ _insert(this, 'afterbegin', any, index); }); },
before: function(any){ return this.each(function(index){ _insert(this, 'beforebegin',any, index); }); },
after: function(any){ return this.each(function(index){ _insert(this, 'afterend', any, index); }); }
而被動式版本也只需一層轉發:
_each({ appendTo: 'append', prependTo: 'prepend', insertBefore: 'before', insertAfter: 'after' }, function(key, val) {
$.fn[key] = function(selector) {
this.each(function() {
$(selector)[val](this);
});
return this;
};
});
看懂這層對應關係,之後再遇到 wrapAll、replaceWith 這類同家族方法,也能很快推斷出它們的行為。