append() 與 appendTo() 這兩個 DOM 操作方法,任務其實一樣:把指定內容插入到被選元素的尾端(仍在元素內部)。但寫法與能力上有幾點差異,以下分別說明。
作用:在被選元素的結尾(但仍在元素內部)插入指定內容。
基本語法:$(selector).append(content),其中 content 為必填,指定要附加的內容。
它還能接受函數,讓每個被選元素依自身狀態決定要附加什麼:
$(selector).append(function(index, html))
其中 function 必填;index 表示該元素在選擇器結果中的索引位置,html 表示該元素目前的 HTML 內容,兩者皆為可選參數。
範例:
<script type="text/javascript" src="/jquery/jquery.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("p").append(" <b>Hello jQuery!</b>");
});
});
</script>
<p>This is a paragraph.</p>
<p>This is another paragraph.</p>
<button>在每個 p 元素的結尾添加內容</button>
執行結果:
This is a paragraph. Hello jQuery!
This is another paragraph. Hello jQuery!
作用同樣是插入到被選元素的結尾,但主詞與受詞顛倒,且不支援傳入函數。
語法:$(content).appendTo(selector);
範例:
<script type="text/javascript" src="/jquery/jquery.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("<b> Hello jQuery!</b>").appendTo("p");
});
});
</script>
<p>This is a paragraph.</p>
<p>This is another paragraph.</p>
<button>在每個 p 元素的結尾添加內容</button>
執行結果一樣:
This is a paragraph. Hello jQuery!
This is another paragraph. Hello jQuery!
兩者可以互相替換,差別只在語句主體:append() 是「被選元素 ← 內容」,appendTo() 是「內容 → 被選元素」。實務上若需要依每個元素的內容或索引做條件判斷,只能用 append();若只是把一段固定的 HTML 塞進多個目標,appendTo() 讀起來更接近自然語言。
類似的成對方法還有 prepend/prependTo、before/insertBefore、after/insertAfter,觀念完全相通。