.prepend()


.prepend( content [, content ] )返回: jQuery

描述: 将参数内容插入到每个匹配元素的前面(元素内部)。

  • 添加的版本: 1.0.prepend( content [, content ] )

    • content
      DOM元素,文本节点,元素和文本节点的数组,HTML字符串,或者jQuery对象,将被插入到匹配元素前的内容。
    • content
      一个或多个DOM元素,文本节点,元素和文本节点的数组,HTML字符串,或者jQuery对象,将被插入到匹配元素前的内容。
  • 添加的版本: 1.4.prepend( function(index, html) )

    • function(index, html)
      类型: Function()
      一个返回HTML字符串,DOM元素(或多个),文本节点(或多个),jQuery对象的函数,该字符串用来插入到匹配元素的开始处。 接收index 参数表示元素在匹配集合中的索引位置和html 参数表示元素上原来的 HTML 内容。在函数中this指向元素集合中的当前元素。

.prepend()方法将指定元素插入到匹配元素里面作为它的第一个子元素 (如果要作为最后一个子元素插入用.append()).

.prepend().prependTo()实现同样的功能,主要的不同是语法,插入的内容和目标的位置不同。 对于 .prepend() 而言,选择器表达式写在方法的前面,作为待插入内容的容器,将要被插入的内容作为方法的参数。而 .prependTo() 正好相反,将要被插入的内容写在方法的前面,可以是选择器表达式或动态创建的标记,待插入内容的容器作为参数。

请看下面的HTML:

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

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

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

每个 <div class="inner"> 元素得到新内容:

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

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

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

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

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

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

Additional Arguments(额外的参数)

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

例如,下面将插入两个新的<div>和现有的<div>到 body作为最后三个子节点:

1
2
3
4
5
var $newdiv1 = $("<div id='object1'></div>"),
newdiv2 = document.createElement('div'),
existingdiv1 = document.getElementById('foo');
$('body').prepend($newdiv1, [newdiv2, existingdiv1]);

.prepend() 可以接受任何数量的额外的参数,相同的结果,可以通过传入三个<div>为三个独立的参数实现,就像这样$('body').prepend($newdiv1, newdiv2, existingdiv1)。参数的类型和数量 将在很大程度上取决于在代码中被收集的元素。

其他注意事项:

  • 设计上,任何jQuery的构造或方法,都接受一个HTML字符串(作为参数) - jQuery(),.append(), .after()等 -可以潜在地执行代码。这可能会出现注入script标签或使用HTML属性执行的代码(例如,<img onload="">)。不要使用这些方法来插入来自不受信任来源的内容,如网址查询参数,Cookie或表单输入获得的字符串。这样做可能会引起跨站点脚本(XSS)漏洞。将内容添加到文档之前删除或避免用户任何输入内容。
  • jQuery没有正式的支持SVG。在SVG文档上使用jQuery方法,除非该方法有明确的说明,否则可能会导致意外的行为。例如jQuery 3.0中支持SVG的方法有addClassremoveClass

例子:

Example: Prepends some HTML to all paragraphs.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!DOCTYPE html>
<html>
<head>
<style>p { background:yellow; }</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<p>there, friend!</p>
<p>amigo!</p>
<script>$("p").prepend("<b>Hello </b>");</script>
</body>
</html>

Demo:

Example: Prepends a DOM Element to all paragraphs.

1
2
3
4
5
6
7
8
9
10
11
12
13
<!DOCTYPE html>
<html>
<head>
<style>p { background:yellow; }</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<p>is what I'd say</p>
<p>is what I said</p>
<script>$("p").prepend(document.createTextNode("Hello "));</script>
</body>
</html>

Demo:

Example: Prepends a jQuery object (similar to an Array of DOM Elements) to all paragraphs.

1
2
3
4
5
6
7
8
9
10
11
12
<!DOCTYPE html>
<html>
<head>
<style>p { background:yellow; }</style>
<script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
<p> is what was said.</p><b>Hello</b>
<script>$("p").prepend( $("b") );</script>
</body>
</html>

Demo: