.appendTo( target )返回: jQuery
描述: 将匹配的元素插入到目标元素的最后面(译者注:内部插入)。
-
添加的版本: 1.0.appendTo( target )
-
target一个选择符,元素,HTML字符串,DOM元素数组,或者jQuery对象;符合的元素们会被插入到由参数指定的目标的末尾。
-
.append()
和.appendTo()
两种方法功能相同,主要的不同是语法——内容和目标的位置不同。对于.append()
,
选择表达式在函数的前面,参数是将要插入的内容。对于.appendTo()
刚好相反,内容在方法前面,无论是一个选择器表达式
或创建作为标记上的标记,它都将被插入到目标容器的末尾。
请看下面的HTML:
1
2
3
4
5
|
|
我们可以创建内容然后同时插入到好几个元素里面:
1
|
|
每个新的inner <div>
元素会得到新的内容:
1
2
3
4
5
6
7
8
9
10
11
|
|
我们也可以在页面上选择一个元素然后插在另一个元素里面:
1
|
|
如果这种方式选择的元素被插入到一个DOM中单一的位置的地方(注:文档中只有一个目标元素),它将被移动到目标中(不是克隆),并返回一组新的插入后的元素集合:
1
2
3
4
5
|
|
然而,如果有多个目标元素,插入元素的克隆副本被创建到每个目标元素,而不是只插入到最后一个目标元素,并且新的集合(原始元素加克隆元素)被返回。(注:看代码示例:http://jsfiddle.net/feiwen8772/f1cmmnue/)
在jQuery 1.9以前,追加到单个元素的情况下没有创建一个新的集合,而是返回原来的集合,当被用与数目不详的元素时,使得它难以可靠地使用.end()
方法。
其他注意事项:
- 设计上,任何jQuery的构造或方法,都接受一个HTML字符串(作为参数) - jQuery(),.append(), .after()等
-可以潜在地执行代码。这可能会出现注入script标签或使用HTML属性执行的代码(例如,
<img onload="">
)。不要使用这些方法来插入来自不受信任来源的内容,如网址查询参数,Cookie或表单输入获得的字符串。这样做可能会引起跨站点脚本(XSS)漏洞。将内容添加到文档之前删除或避免用户任何输入内容。 - jQuery没有正式的支持SVG。在SVG文档上使用jQuery方法,除非该方法有明确的说明,否则可能会导致意外的行为。例如jQuery 3.0中支持SVG的方法有
addClass
和removeClass
。
例子:
将所有的 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
|
|