jQuery.append() 函數詳解

append()函數用於向每個匹配元素內部的末尾位置追加指定的內容。

指定的內容可以是：html字串、DOM元素(或陣列)、jQuery物件、函數(傳回值)。

與該函數相對的是prepend()函數，用於向每個匹配元素內部的起始位置追加指定的內容。

此函數屬於jQuery物件(實例)。

語法

jQueryObject.append( content1 [, content2 [, contentN ]] )

參數

參數 說明

#content1 String /Element/jQuery/Function類型指定的追加內容。

content2 可選/String/Element/jQuery類型指定的追加內容。

contentN 可選/String/Element/jQuery類型指定的追加內容，可以有任意多個。

append()可以將多個參數所表示的內容依序追加到每個符合元素內部的末端位置。如果參數為字串類型，則將其視為html字串。

jQuery 1.4 新增支援：參數content1可以為函數。 append()將根據匹配的所有元素遍歷執行該函數，函數中的this將指向對應的DOM元素。

append()也會為函數傳入兩個參數：第一個參數就是目前元素在符合元素中的索引，第二個參數就是該元素目前的內部html內容(innerHTML)。 函數的回傳值就是需要為該元素追加的內容(可以是html字串、DOM元素、jQuery物件)。

注意：只有第一個參數可以為自訂函數，用於遍歷執行。如果之後的參數也為函數，則呼叫其toString()方法，將其轉為字串，並視為html內容。

傳回值

append()函數的傳回值為jQuery類型，傳回目前jQuery物件本身(以便於進行鍊式風格的程式設計)。

注意：如果追加的內容是目前頁面中的某些元素，那麼這些元素將從原始位置上消失。簡而言之，這相當於一個移動操作，而不是複製操作。

範例&說明

append()函數用於將每個符合元素內部的結尾位置追加內容：

<p>段落文本1<span></span><!--插入到p元素内部的末尾位置--></p>
<p>段落文本2<span></span><!--插入到p元素内部的末尾位置--></p>
<script type="text/javascript">
$("p").append( &#39;<!--插入到p元素内部的末尾位置-->&#39; ); 
</script>

請注意append()函數和appendTo()函數的差異：

var $A = $("s1");
var $B = $("s2");
// 将$B追加到$A中
$A.append( $B ); // 返回$A
// 将$A追加到$B中
$A.appendTo( $B ); // 返回表示追加内容的jQuery对象( 匹配所有$B内部末尾追加的$A )

以下面這段HTML程式碼為例：

<p id="n1">
    <span id="n2">CodePlayer</span>    
</p>
<p id="n3">
    <label class="move">Hello World</label>
</p>
<p id="n4">
    <i>测试内容</i>
</p>

以下jQuery範例程式碼用於示範append()函數的具體用法：

var $n1 = $("#n1");
// 将一个strong标记追加到n1内部的末尾位置
$n1.append( &#39;<strong>追加内容</strong>&#39; );
// 将所有的label元素和i元素追加到n1内部的末尾位置
// 原来位置的label元素和i元素会消失(相当于是移动到n1内部的末尾位置)
$n1.append( document.getElementsByTagName("label"), $("i") );
// 为每个p元素内部的末尾位置追加一个span元素，html内容根据索引而有所不同
var $p = $("p");
$p.append( function(index, html){
    return &#39;<span>追加元素&#39; + (index + 1) + &#39;</span>&#39;;  
} );

append ()會將內容追加到指定容器元素的結束標記之前，不會額外添加任何空白字符，上述代碼執行後的完整html代碼如下(格式未作任何調整)：

<p id="n1">
    <span id="n2">CodePlayer</span>    
<strong>追加内容</strong><label class="move">Hello World</label><i>测试内容</i><span>追加元素1</span></p>
<p id="n3">
    
<span>追加元素2</span></p>
<p id="n4">
    
<span>追加元素3</span></p>

以上是jQuery.append() 函數詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！