概述 .append( content [, content ] )
返回值:jQuery
描述:在每个匹配元素里面的末尾处插入参数内容。
this
指向元素集合中的当前元素。
.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>
如果有多个目标元素,内容将被复制然后按顺序插入到每个目标里面。
和其他添加内容的方法类似, 例如.prepend()
和 .before()
, .append()
还支持传递输入多个参数。支持的输入包括DOM元素,jQuery对象,HTML字符串,DOM元素的数组。
例如,下面将插入两个新的<div>
和现有的<div>
到 body作为最后三个子节点:
var $newdiv1 = $("<div id='object1'></div>"),
newdiv2 = document.createElement('div'),
existingdiv1 = document.getElementById('foo');
$('body').append($newdiv1, [newdiv2, existingdiv1]);
.append()
可以接受任何数量的额外的参数,所以上面的示例中,也可以将三个独立的 <div> 分别作为参数传给该方法,就像这样$('body').append($newdiv1, newdiv2, existingdiv1)
。参数的类型和数量,将在很大程度上取决于你是如何选择元素的。
<img onload="">
)。不要使用这些方法来插入来自不受信任来源的内容,如网址查询参数,Cookie或表单输入获得的字符串。这样做可能会引起跨站点脚本(XSS)漏洞。将内容添加到文档之前删除或避免用户任何输入内容。
addClass
和 removeClass
。
示例
在所有的段落内的尾部,追加一些 HTML。
<!DOCTYPE html>
<html>
<head>
<style>
p { background:yellow; }
</style>
<script src="http://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>
在所有的段落内的尾部,追加一个元素。
<!DOCTYPE html>
<html>
<head>
<style>
p { background:yellow; }
</style>
<script src="http://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>
在所有的段落内的尾部,追加一个 jQuery 对象(类似于一个 DOM 元素数组)。
<!DOCTYPE html>
<html>
<head>
<style>
p { background:yellow; }
</style>
<script src="http://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>