.prependTo()

.prependTo( target ) Returns: jQuery

描述:将所有元素插入到目标前面(元素内)。

  • version added: 1.0.prependTo( target )

    target一个选择符,元素,HTML字符串或者jQuery对象;符合的元素们会被插入到由参数指定的目标的开头。

.prepend().prependTo()实现同样的功能,主要的不同时语法,插入的内容和目标的位置不同。对于 .prepend(),函数前面的是插入的容器,参数是内容。而.prependTo()刚好相反。

请看下面的HTML

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

我们可以创建内容然后同时插入到好几个元素里面:

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

结果如下:

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

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

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

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

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

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

例子

将所有span插入到ID为“foo”的元素前面。

<!DOCTYPE html>
<html>
<head>
  <style>div { background:yellow; }</style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <div id="foo">FOO!</div>

  <span>I have something to say... </span>
<script>$("span").prependTo("#foo"); // check prepend() examples</script>

</body>
</html>

Demo:

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