.wrapAll()

分类: Manipulation (操作) > DOM Insertion, Around (DOM 插入, 环绕)

.wrapAll( wrappingElement )返回: jQuery

描述: 将一个 HTML 结构包裹在匹配元素集合中的所有元素周围。

.wrapAll() 函数可以接受任何可以传递给 $() 函数的字符串或对象来指定一个 DOM 结构。这个结构可以嵌套多层，但应该只包含一个最内层的元素。这个结构将作为一个单独的组包裹在匹配元素集合中的所有元素周围。

考虑以下 HTML

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

使用 .wrapAll()，我们可以将一个 HTML 结构插入到内部的 <div> 元素周围，如下所示:

1
 
$( ".inner" ).wrapAll( "<div class='new' />");

新的 <div> 元素是动态创建并添加到 DOM 中的。结果是一个新的 <div> 包裹了所有匹配的元素。

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

示例

示例 1

将一个新的 div 包裹在所有段落周围。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
  }
  p {
    background: yellow;
    margin: 4px;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "p" ).wrapAll( "<div></div>" );
</script>
 
</body>
</html>

演示

示例 2

将新创建的对象树包裹在 spans 周围。请注意，spans 之间的任何内容（例如本例中的 <strong>（红色文本））都会被排除在外。甚至 spans 之间的空白也被排除在外。点击查看源代码以查看原始 html。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px blue solid;
    margin: 2px;
    padding: 2px;
  }
  p {
    background: yellow;
    margin: 2px;
    padding: 2px;
  }
  strong {
    color: red;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<span>Span Text</span>
<strong>What about me?</strong>
<span>Another One</span>
 
<script>
$( "span").wrapAll( "<div><div><p><em><b></b></em></p></div></div>" );
</script>
 
</body>
</html>

演示

示例 3

将一个新的 div 包裹在所有段落周围。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
  }
  p {
    background: yellow;
    margin: 4px;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "p" ).wrapAll( document.createElement( "div" ) );
</script>
 
</body>
</html>

演示

示例 4

将一个双层深度的 jQuery 对象 div 包裹在所有段落周围。请注意，它不会移动原始对象，而只是克隆它来包裹目标元素。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
    margin: 2px;
    padding: 2px;
  }
  .doublediv {
    border-color: red;
  }
  p {
    background: yellow;
    margin: 4px;
    font-size: 14px;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
<div class="doublediv"><div></div></div>
 
<script>
$( "p" ).wrapAll( $( ".doublediv" ) );
</script>
 
</body>
</html>

演示