append()

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

.append ( content [, content ])
  • content 类型: String, Element, jQuery 。DOM 元素,DOM元素数组,HTML字符串,或者jQuery对象,用来插在每个匹配元素里面的末尾。
  • content 类型: String, Element, Array, jQuery 。一个或多个DOM元素,元素数组,HTML字符串,或jQuery对象插入到每个匹配元素的末尾。
.append ( function ( index, html ))
  • function(index, html) 类型:Function() 。一个返回HTML字符串,DOM元素,jQuery对象的函数,该字符串用来插入到匹配元素的末尾。接收index 参数表示元素在匹配集合中的索引位置和html 参数表示元素上原来的 HTML 内容。在函数中 this 指向元素集合中的当前元素。

.append(content[, content ])

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

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

请看下面的HTML:

<h2>Greetings</h2>
<div class="container">
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

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

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

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

<h2>Greetings</h2>
<div class="container">
  <div class="inner">
    Hello
    <p>Test</p>
  </div>
  <div class="inner">
    Goodbye
    <p>Test</p>
  </div>
</div>

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

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

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

<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作为最后三个子节点:

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) 。参数的类型和数量,将在很大程度上取决于你是如何选择元素的。

例子

在所有的段落内的尾部,追加一些 HTML。

<!DOCTYPE html>
<html>
<head>
  <style>
  p { background:yellow; }
</style>
  <script src="./static/js/jquery-3.5.0.js"></script>
</head>
<body>
  <p>I would like to say: </p>
<script>
  $("p").append("<strong>Hello</strong>");
</script>
 
</body>
</html>

I would like to say:

在所有的段落内的尾部,追加一个元素。

<!DOCTYPE html>
<html>
<head>
  <style>
  p { background:yellow; }
</style>
  <script src="./static/js/jquery-3.5.0.js"></script>
</head>
<body>
  <p>I would like to say: </p>
 
<script>
  $("p").append(document.createTextNode("Hello"));
</script>
 
</body>
</html>

I would like to say:

在所有的段落内的尾部,追加一个 jQuery 对象(类似于一个 DOM 元素数组)。

<!DOCTYPE html>
<html>
<head>
  <style>
  p { background:yellow; }
</style>
  <script src="./static/js/jquery-3.5.0.js"></script>
</head>
<body>
  <strong>Hello world!!!</strong><p>I would like to say: </p>
<script>
  $("p").append( $("strong") );
</script>
 
</body>
</html>
Hello world!!!

I would like to say:

上篇: html()

下篇: appendTo()