before()

.before() 和.insertBefore()实现同样的功能。主要的不同是语法——内容和目标的位置不同。 对于.before(),要插入的内容来自方法的参数：$(target).before(contentToBeInserted) （手册网注：即，选择器表达式在方法的前面，参数是将要插入的内容） 。 对于.insertBefore()， 刚好相反，内容在方法前面并且插入到目标的前面， 而目标是传递给.insertBefore()方法的参数： $(contentToBeInserted).insertBefore(target)。

请看下面的HTML:

<div class="container">
  <h2>Greetings</h2>
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

你可以创建内容然后同时插入到多个元素前面：

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

每个新的inner <div>元素会得到新的内容：

<div class="container">
  <h2>Greetings</h2>
  <p>Test</p>
  <div class="inner">Hello</div>
  <p>Test</p>
  <div class="inner">Goodbye</div>
</div>

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

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

如果这样，一个被选中的元素插入被到DOM中的一个别的位置， 它将移动到目标的前面（而不是克隆）：

<h2>Greetings</h2>
<div class="container">
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

重要提示： 如果有多个目标元素，将要为每个目标元素创建插入元素的克隆副本，除了最后一个。 然而，对于除了最后一个每个目标将要创建的插入元件的克隆副本。

$("<div/>").before("<p></p>");

Additional Arguments（额外的参数）

类似的其他内容的添加方法  如.prepend() 和 .after() ,.before()还支持传递输入多个参数。支持的输入包括DOM元素，jQuery对象，HTML字符串，DOM元素的数组。

例如，下面将插入两个新的<div>和现有的<div>到 第一个段落：

var $newdiv1 = $("<div id='object1'></div>"),
    newdiv2 = document.createElement('div'),
    existingdiv1 = document.getElementById('foo');
 
$('p').first().before($newdiv1, [newdiv2, existingdiv1]);

.before() 可以接受任何数量的额外的参数，所以上面的示例中，也可以将三个独立的 <div> 分别作为参数传给该方法，就像这样$('p').first().before($newdiv1, newdiv2, existingdiv1)。参数的类型和数量 将在很大程度上取决于在代码中被收集的元素。

• 在此之前的jQuery1.9， 如果该集合中的第一个节点没有在文档中， .before()将尝试添加 或 在当前的jQuery集合改变节点，在这种情况下返回一个新的jQuery集合，而不是原来的集合。 该方法可能会或可能不会返回一个新的结果，这取决于它的参数个数或参数的连贯性！ 从jQuery1.9开始，.after(), .before(), 和 .replaceWith()总是返回原始未修改的集合。 试图在一个没有父级元素的节点上使用这些方法是没有效果的，也就是说，集合和它包含的节点都不会改变。
• 设计上，任何jQuery的构造或方法，都接受一个HTML字符串（作为参数） - jQuery(), .append(), .after()等 - 可以潜在地执行代码。 这可能会出现注入script标签或使用HTML属性  执行的代码（例如，<img onload="">）。 不要使用这些方法来插入来自不受信任的来源，如网址查询参数，Cookie或表单输入获得的字符串。 这样做可能会引起跨站点脚本（XSS）漏洞。 将内容添加到文档之前删除或避开用户任何输入内容。