.append()

.append( content ) 返回:jQuery

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

  • version added: 1.0.append( content )

    content一个元素,HTML字符串,或者jQuery对象,用来插在每个匹配元素里面的末尾。

  • version added: 1.4.append( function(index, html) )

    function(index, html)一个返回HTML字符串的函数,该字符串用来插入到匹配元素的末尾。 Receives the index position of the element in the set and the old HTML value of the element as arguments.

.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>

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

例子:

Example: 在所有的段落里插入一些HTML。

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

</body>
</html>

Demo:

Example: 在所有段落里插入元素。

<!DOCTYPE html>
<html>
<head>
  <style>
  p { background:yellow; }
</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <p>I would like to say: </p>

<script>
  $("p").append(document.createTextNode("Hello"));
</script>

</body>
</html>

Demo:

Example: 在所有段落里插入jQuery对象 (jQuery对象类似于一组DOM元素)

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

</body>
</html>

Demo:

jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)