.insertBefore()

.insertBefore( target ) 返回:jQuery

Description: 在目标前插入所有匹配元素。

  • version added: 1.0.insertBefore( target )

    target一个选择器,元素,THML字符串或者jQuery对象,匹配的元素将会被插入在由参数指定的目标后面。

The .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>

如果有多个目标元素,内容将被复制然后被插入到每个目标前面。

例子:

在id为"foo"的元素前面插入段落。和 $("#foo").before("p")一样。

<!DOCTYPE html>
<html>
<head>
  <style>#foo { background:yellow; }</style>
  <script src="http://code.jquery.com/jquery-latest.min.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>

Demo:

jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)