.addBack()

所属分类：Traversing > Miscellaneous Traversing 英文文档：.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
 
<!DOCTYPE html>
<html>
<head>
  <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-latest.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>

Demo: