# .append()

所属分类：DOM 操作 > DOM 插入现有元素内 英文文档：.append()

## .append( content [, content ] )返回: jQuery

描述: 在每个匹配元素里面的末尾处插入参数内容。

- #### 添加的版本: 1.0.append( content [, content ] )

  - content
    类型: String, Element, jQuery
    DOM 元素，DOM元素数组，HTML字符串，或者jQuery对象，用来插在每个匹配元素里面的末尾。
  - content
    类型: String, Element, Array, jQuery
    一个或多个DOM元素，元素数组，HTML字符串，或jQuery对象插入到每个匹配元素的末尾。

- #### 添加的版本: 1.4.append( function(index, html) )

  - function(index, html)
    类型: Function()
    一个返回HTML字符串，DOM元素，jQuery对象的函数，该字符串用来插入到匹配元素的末尾。接收index 参数表示元素在匹配集合中的索引位置和html 参数表示元素上原来的 HTML 内容。在函数中`this`指向元素集合中的当前元素。

`.append()`函数将特定内容插入到每个匹配元素里面的最后面，作为它的最后一个子元素（last child）, (如果要作为第一个子元素 （first child）, 用`.prepend()`).

`.append()` 和.appendTo()实现同样的功能。主要的不同是语法——内容和目标的位置不同。对于`.append()`, 选择器表达式在函数的前面，参数是将要插入的内容。对于`.appendTo()`刚好相反，内容在方法前面，无论是一个选择器表达式 或创建作为标记上的标记，它都将被插入到目标容器的末尾。

请看下面的HTML:

1 2 3 4 5 |
    <h2>Greetings</h2><div class="container">  <div class="inner">Hello</div>  <div class="inner">Goodbye</div></div>

你可以创建内容然后同时插入到好几个元素里面：

1 |
    $('.inner').append('<p>Test</p>');

每个新的inner `<div>`元素会得到新的内容：

1 2 3 4 5 6 7 8 9 10 11 |
    <h2>Greetings</h2><div class="container">  <div class="inner">    Hello    <p>Test</p>  </div>  <div class="inner">    Goodbye    <p>Test</p>  </div></div>

你也可以在页面上选择一个元素然后插在另一个元素里面：

1 |
    $('.container').append($('h2'));

如果一个被选中的元素被插入到另外一个地方，这是移动而不是复制：

1 2 3 4 5 |
    <div class="container">  <div class="inner">Hello</div>  <div class="inner">Goodbye</div>  <h2>Greetings</h2></div>

如果有多个目标元素，内容将被复制然后按顺序插入到每个目标里面。

#### Additional Arguments（额外的参数）

和其他添加内容的方法类似， 例如`.prepend()` 和 `.before()`, `.append()` 还支持传递输入多个参数。支持的输入包括DOM元素，jQuery对象，HTML字符串，DOM元素的数组。

例如，下面将插入两个新的`<div>`和现有的`<div>`到 body作为最后三个子节点：

1 2 3 4 5 |
    var $newdiv1 = $('<div id="object1"/>'),    newdiv2 = document.createElement('div'),    existingdiv1 = document.getElementById('foo'); $('body').append($newdiv1, [newdiv2, existingdiv1]);

`.append()` 可以接受任何数量的额外的参数，所以上面的例子中，也可以将三个独立的 <div> 分别作为参数传给该方法，就像这样`$('body').append($newdiv1, newdiv2, existingdiv1)`。参数的类型和数量，将在很大程度上取决于你是如何选择元素的。

## 例子:

#### Example: 在所有的段落内的尾部，追加一些 HTML。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
    <!DOCTYPE html><html><head>  <style>  p { background:yellow; }</style>  <script src="https://code.jquery.com/jquery-latest.js"></script></head><body>  <p>I would like to say: </p><script>  $("p").append("<strong>Hello</strong>");</script> </body></html>

#### Demo:

#### Example: 在所有的段落内的尾部，追加一个元素。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
    <!DOCTYPE html><html><head>  <style>  p { background:yellow; }</style>  <script src="https://code.jquery.com/jquery-latest.js"></script></head><body>  <p>I would like to say: </p> <script>  $("p").append(document.createTextNode("Hello"));</script> </body></html>

#### Demo:

#### Example: 在所有的段落内的尾部，追加一个 jQuery 对象（类似于一个 DOM 元素数组）。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
    <!DOCTYPE html><html><head>  <style>  p { background:yellow; }</style>  <script src="https://code.jquery.com/jquery-latest.js"></script></head><body>  <strong>Hello world!!!</strong><p>I would like to say: </p><script>  $("p").append( $("strong") );</script> </body></html>

#### Demo: