.replaceAll()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.replaceAll()

分类:操纵 > DOM替代

返回: jQuery

.replaceAll( target )

描述:用匹配的元素集合替代每一个目标元素。

加入于: 1.2
.replaceAll( target )
  • target
    类型:Selector or jQuery or Array or Element
    一个选择器字符串、jQuery对象、DOM元素,或者元素的数组,表示哪些元素要替换掉。

.replaceAll()方法近似于.replaceWith(),但是源元素和目标元素颠倒过来了。设想这样的DOM结构:

<div class="container">
  <div class="inner first">Hello</div>
  <div class="inner second">And</div>
  <div class="inner third">Goodbye</div>
</div>

我们可以创建一个元素,然后用它替换掉别的元素。

$( "<h2>New heading</h2>" ).replaceAll( ".inner" );

这将导致它们全被替换掉了:

<div class="container">
  <h2>New heading</h2>
  <h2>New heading</h2>
  <h2>New heading</h2>
</div>

我们还可以选择一个元素,用作替换的内容:

$( ".first" ).replaceAll( ".third" );

这导致DOM结构变成:

<div class="container">
  <div class="inner second">And</div>
  <div class="inner first">Hello</div>
</div>

从这个示例中,我们可以看到被选中的元素代替了目标元素,是把它从它的旧位置移过来,而不是克隆过来。

其它说明

  • .replaceAll()方法除了删除元素,还删除了所有的和被删除的元素有关的数据以及事件处理函数。

示例

用加粗词语替换掉所有的段落文本。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>replaceAll demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "<b>Paragraph. </b>" ).replaceAll( "p" );
</script>
 
</body>
</html>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/replaceall.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。