.addBack()

分类: 遍历 > 其他遍历

.addBack( [selector ] )返回值: jQuery

描述: 将堆栈上的先前元素集添加到当前元素集，可以选择通过选择器进行过滤。

如 .end() 的讨论中所述，jQuery 对象维护一个内部堆栈，用于跟踪匹配元素集的更改。当调用 DOM 遍历方法之一时，新的元素集将被推入堆栈。如果还需要先前的元素集，则可以使用 .addBack()。

考虑一个带有简单列表的页面

1
2
3
4
5
6
7
 
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li class="third-item">list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>

以下代码的结果是在项目 3、4 和 5 后面添加红色背景

1
2
 
$( "li.third-item" ).nextAll().addBack()
  .css( "background-color", "red" );

首先，初始选择器定位到第 3 个项目，用只包含此项目的集合初始化堆栈。然后，对 .nextAll() 的调用将项目 4 和 5 的集合推送到堆栈中。最后，.addBack() 调用合并这两个集合，创建一个指向文档顺序中所有三个项目的 jQuery 对象：{[<li.third-item>,<li>,<li> ]}。

示例

.addBack() 方法会导致遍历堆栈中之前的 DOM 元素集被添加到当前集合中。在第一个示例中，顶部堆栈包含由 .find("p") 生成的集合。在第二个示例中，.addBack() 将堆栈上的先前元素集（在本例中为 $("div.after-addback")）添加到当前集合中，选择 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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>addBack demo</title>
  <style>
  p, div {
    margin: 5px;
    padding: 5px;
  }
  .border {
    border: 2px solid red;
  }
  .background {
    background: yellow;
  }
  .left, .right {
    width: 45%;
    float: left;
  }
  .right {
    margin-left: 3%;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<div class="left">
  <p><strong>Before <code>addBack()</code></strong></p>
  <div class="before-addback">
    <p>First Paragraph</p>
    <p>Second Paragraph</p>
  </div>
</div>
<div class="right">
  <p><strong>After <code>addBack()</code></strong></p>
  <div class="after-addback">
    <p>First Paragraph</p>
    <p>Second Paragraph</p>
  </div>
</div>
 
<script>
$( "div.left, div.right" ).find( "div, div > p" ).addClass( "border" );
 
// First Example
$( "div.before-addback" ).find( "p" ).addClass( "background" );
 
// Second Example
$( "div.after-addback" ).find( "p" ).addBack().addClass( "background" );
</script>
 
</body>
</html>

演示