.appendTo()


.appendTo( target )返回: jQuery

描述: 将匹配的元素插入到目标元素的最后面(译者注:内部插入)。

  • 添加的版本: 1.0.appendTo( target )

    • target
      一个选择符,元素,HTML字符串,DOM元素数组,或者jQuery对象;符合的元素们会被插入到由参数指定的目标的末尾。

.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
$('<p>Test</p>').appendTo('.inner');

每个新的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
$('h2').appendTo($('.container'));

如果这种方式选择的元素被插入到一个DOM中单一的位置的地方(注:文档中只有一个目标元素),它将被移动到目标中(不是克隆),并返回一组新的插入后的元素集合:

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

如果有多个目标元素,内容将被复制然后按顺序插入到每个目标里面。新的集合(原始元素加克隆元素)被返回。

例子:

将所有的 span 插入到 ID 为 "foo" 的元素内的末尾。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>appendTo demo</title>
<style>
#foo {
background: yellow;
}
</style>
<script src="//code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<span>I have nothing more to say... </span>
<div id="foo">FOO! </div>
<script>
$( "span" ).appendTo( "#foo" );
</script>
</body>
</html>

Demo: