概述 .after( content [, content ] )
返回值:jQuery
描述: 在匹配元素集合中的每个元素后面插入参数所指定的内容,作为其兄弟节点。
this
指向元素集合中的当前元素。
this
指向元素集合中的当前元素。
.after()
和.insertAfter()实现同样的功能。主要的不同是语法——内容和目标的位置不同。
对于.after()
,要插入的内容来自方法的参数:$(target).after(contentToBeInserted)
(手册网注:即,选择器表达式在方法的前面,参数是将要插入的内容) 。
对于.insertAfter()
,
刚好相反,内容在方法前面并且插入到目标的前面,
而目标是传递给.insertAfter()
方法的参数: $(contentToBeInserted).insertAfter(target)
。
请看下面的HTML:
<div class="container">
<h2>Greetings</h2>
<div class="inner">Hello</div>
<div class="inner">Goodbye</div>
</div>
我们可以创建内容然后同时插在好几个元素后面:
$('.inner').after('<p>Test</p>');
每个内部的 <div>
元素得到新的内容:
<div class="container">
<h2>Greetings</h2>
<div class="inner">Hello</div>
<p>Test</p>
<div class="inner">Goodbye</div>
<p>Test</p>
</div>
我们也可以在页面上选择一个元素然后插在另一个元素后面:
$('.container').after($('h2'));
如果这样,一个被选中的元素插入被到DOM中的一个别的位置, 它将移动到目标的前面(而不是克隆):
<div class="container">
<div class="inner">Hello</div>
<div class="inner">Goodbye</div>
</div>
<h2>Greetings</h2>
重要提示: 如果有多个目标元素,将要为每个目标元素创建插入元素的克隆副本,除了最后一个。 然而,对于除了最后一个每个目标将要创建的插入元件的克隆副本。
如果有多个目标元素,内容将被复制然后被插入到每个目标后面。
对于jQuery 1.4, .before()
和.after()
同时也会对分离的DOM元素有效。例如,下面的代码:
$('<div/>').after('<p></p>');
结果是一个包含一个div和一个段落的JQuery集合。因此,我们可以更进一步操作这个集合,即使在将它插入document之前。
$('<div/>').after('<p></p>').addClass('foo')
.filter('p').attr('id', 'bar').html('hello')
.end()
.appendTo('body');
结果是下面的代码被插到</body>
标签之前:
<div class="foo"></div>
<p class="foo" id="bar">hello</p>
从jQuery 1.4开始, .after()
允许我们传入一个函数,该函数返回要被插入的元素。
$('p').after(function() {
return '<div>' + this.className + '</div>';
});
上面的代码在每个段落后插入一个<div>
,<div>
里面是该段落的class名称。
和其他添加内容的方法类似, 如.prepend()
和 .before()
, .after()
还支持传递输入多个参数。
支持的输入包括DOM元素,jQuery对象,HTML字符串,DOM元素的数组。
例如,下面将插入两个新的<div>和现有的<div>到第一个段落后面:
var $newdiv1 = $("<div id='object1'></div>"),
newdiv2 = document.createElement('div'),
existingdiv1 = document.getElementById('foo');
$('p').first().after($newdiv1, [newdiv2, existingdiv1]);
.after()
可以接受任何数量的额外的参数,所以上面的示例中,也可以将三个独立的 <div> 分别作为参数传给该方法,就像这样$('p').first().after($newdiv1, newdiv2, existingdiv1)
。参数的类型和数量,将在很大程度上取决于你是如何选择元素的。
.after()
将尝试添加 或 在当前的jQuery集合改变节点,在这种情况下返回一个新的jQuery集合,而不是原来的集合。该方法可能会或可能不会返回一个新的结果,这取决于它的参数个数或参数的连贯性!
从jQuery1.9开始,.after()
, .before()
,
和 .replaceWith()
总是返回原始未修改的集合。
试图在一个没有父级元素的节点上使用这些方法是没有效果的,也就是说,集合和它包含的节点都不会改变。
<img
onload="">
)。
不要使用这些方法来插入来自不受信任的来源,如网址查询参数,Cookie或表单输入获得的字符串。
这样做可能会引起跨站点脚本(XSS)漏洞。
将内容添加到文档之前删除或避开用户任何输入内容。
示例
在所有的段落后插入一些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").after("<b>Hello</b>");</script>
</body>
</html>
在所有的段落后插入一个DOM元素。
<!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").after( document.createTextNode("Hello") );</script>
</body>
</html>
在所有段落后插入一个jQuery对象。
<!DOCTYPE html>
<html>
<head>
<style>p { background:yellow; }</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<b>Hello</b><p>I would like to say: </p>
<script>$("p").after( $("b") );</script>
</body>
</html>