.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对象，按文档顺序指向所有三个项。

示例：

.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.jquery.com/jquery-1.10.2.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>

演示：