DIV CSS 佈局教程網

append、prepend、before、after 一次講清楚:jQuery 節點插入方法全解析
編輯:JQuery入門技巧     

jQuery 提供了好幾組「插入」方法,名字相近、行為卻各異,初學時最容易搞混。關鍵在於兩個維度:插在哪裡(元素內部還是元素外部),以及放在前還是放在後。另外每組方法都有一個「主動式」與「被動式」的孿生兄弟,兩者效果相同,差別只在回傳值。

一、after() 與 before():插在被選元素的外部

A.after(B) 是把 B 放到 A 的後面,兩者是兄弟關係;A.before(B) 則是把 B 放到 A 的前面。也就是說,被插入的內容並不會成為 A 的子元素。

二、insertAfter() 與 insertBefore():交換位置

這兩個方法的主詞與上一組相反。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>,兩者位置對調。

三、append() 與 appendTo():插進元素內部的最後

A.append(B) 是把 B 塞進 A 裡面,成為 A 的最後一個子節點。反過來,A.appendTo(B) 是把 A 塞進 B 裡面,同樣放在 B 的最後。

四、prepend() 與 prependTo():插進元素內部的最前

與 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 這類同家族方法,也能很快推斷出它們的行為。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved