.before()

.before( content ) 返回:jQuery

描述: 根据参数设定在匹配元素的前面(外面)插入内容

  • version added: 1.0.before( content )

    content一个元素,HTML字符串,或者jQuery对象,用来插入到匹配元素前面的内容

  • version added: 1.4.before( function )

    function一个返回THML字符串的函数,返回值作为用来被插入到陪陪元素前面的内容。

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

请看下面的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>

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

$('.container').before($('h2'));

如果一个被选中的元素被这样插入到另外一个地方,这是移动而不是复制:

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

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

在jQuery 1.4中, .before().after()同样对分离的DOM节点有效:

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

结果是一个jQuery set包含一个段落和一个 div。

例子:

Example: 在所有段落前插入一些HTML。

<!DOCTYPE html>
<html>
<head>
  <style>p { background:yellow; }</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <p> is what I said...</p>
<script>$("p").before("<b>Hello</b>");</script>

</body>
</html>

Demo:

Example: 在所有段落前插入一个DOM元素。

<!DOCTYPE html>
<html>
<head>
  <style>p { background:yellow; }</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <p> is what I said...</p>
<script>$("p").before( document.createTextNode("Hello") );</script>

</body>
</html>

Demo:

Example: 在所有段落前插入一个jQuery对象(类似于一个DOM元素数组)。

<!DOCTYPE html>
<html>
<head>
  <style>p { background:yellow; }</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <p> is what I said...</p><b>Hello</b>
<script>$("p").before( $("b") );</script>

</body>
</html>

Demo:

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