.insertBefore()

分类: Manipulation > DOM Insertion, Outside

.insertBefore( target )返回: jQuery

描述: 在目标元素前面插入集合中每个匹配的元素(注：插入的元素作为目标元素的兄弟元素)。

  • 添加的版本: 1.0.insertBefore( target )

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

The .before()和.insertBefore()实现同样的功能。主要的区别是语法——内容和目标的位置。 对于 .before()，选择表达式在函数前面，内容作为参数，而.insertBefore()刚好相反，内容在方法前面，它将被放在参数里元素的前面。

请看下面的HTML：

1
2
3
4
5
 
<div class="container">
  <h2>Greetings</h2>
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

我们可以创建内容然后同时插在好几个元素前面：

1
 
$('<p>Test</p>').insertBefore('.inner');

得到新内容如下：

1
2
3
4
5
6
7
 
<div class="container">
  <h2>Greetings</h2>
  <p>Test</p>
  <div class="inner">Hello</div>
  <p>Test</p>
  <div class="inner">Goodbye</div>
</div>

我们也可以在页面上选择一个元素然后插在另一个元素前面：

1
 
$('h2').insertBefore($('.container'));

如果一个被选中的元素被插在另外一个地方，它将被移动到目标元素的前面，注意是移动而不是复制：

1
2
3
4
5
 
<h2>Greetings</h2>
<div class="container">
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

如果有多个目标元素，会将克隆拷贝插入的元素，插入到每个目标元素的前面，然后返回新集合（原始元素和克隆元素）。

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。

例子:

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

（感谢 薄荷幸运四叶草网友指出错误。）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>insertBefore demo</title>
  <style>
  #foo {
    background: yellow;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div id="foo">FOO!</div>
<p>I would like to say: </p>
 
<script>
$( "p" ).insertBefore( "#foo" );
</script>
 
</body>
</html>

Demo: