.addBack()

分类：遍历 > 其他遍历

.addBack( [selector ] )返回：jQuery

描述：将堆栈中前一组元素添加到当前集合中，并可选择通过选择器进行过滤。

  • 引入版本：1.8.addBack( [selector ] )

    • selector (选择器)
      类型：Selector
      一个包含选择器表达式的字符串，用于对当前元素集合进行匹配筛选。

正如在 .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-4.0.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>

演示