insertBefore()
在目标元素前面插入集合中每个匹配的元素,插入的元素作为目标元素的兄弟元素。
.insertBefore (target)
target类型: Selector, Element, jQuery。一个选择器,元素,HTML字符串或者jQuery对象,匹配的元素将会被插入在由参数指定的目标后面。
.before()
和.insertBefore()
实现同样的功能。主要的区别是语法——内容和目标的位置。对于.before()
,选择表达式在函数前面,内容作为参数,而.insertBefore()
刚好相反,内容在方法前面,它将被放在参数里元素的前面。
请看下面的HTML:
<div class="container"> <h2>Greetings</h2> <div class="inner">Hello</div> <div class="inner">Goodbye</div> </div>
我们可以创建内容然后同时插在好几个元素前面:
$('<p>Test</p>').insertBefore('.inner');
得到新内容如下:
<div class="container"> <h2>Greetings</h2> <p>Test</p> <div class="inner">Hello</div> <p>Test</p> <div class="inner">Goodbye</div> </div>
我们也可以在页面上选择一个元素然后插在另一个元素前面:
$('h2').insertBefore($('.container'));
如果一个被选中的元素被插在另外一个地方,它将被移动到目标元素的前面,注意是移动而不是复制:
<h2>Greetings</h2> <div class="container"> <div class="inner">Hello</div> <div class="inner">Goodbye</div> </div>
如果有多个目标元素,会将克隆拷贝插入的元素,插入到每个目标元素的前面,然后返回新集合(原始元素和克隆元素)。
jQuery 1.9之前,追加到单元素的情况下没有创建一个新的集合,而返回原来的集合,当使用一个未知个数的元素时,这使我们难以使用.end()
方法。
例子
在id为"foo"的元素前面插入段落。和$("#foo").before("p")一样。
<!DOCTYPE html>
<html>
<head>
<style>#foo { background:yellow; }</style>
<script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
</head>
<body>
<div id="foo">FOO!</div><p>I would like to say: </p>
<script>$("p").insertBefore("#foo"); // check before() examples</script>
</body>
</html>