.andSelf()

所属分类：遍历 > 其它遍历 | 弃用 > 1.8 版本弃用的 API | 已删除的函数 英文文档：.andSelf()

.andSelf()返回: jQueryversion deprecated: 1.8

描述: 添加先前的堆栈元素集合到当前组合。

  • 添加的版本: 1.2.andSelf()

    • 这个方法不接受任何参数

注意: 此函数已过时，现在是.addBack()的一个别名。在jQuery1.8和更高版本中应使用.addBack()。

如上所述在讨论中的.end()， jQuery对象维护一个堆栈内部来跟踪匹配的元素集合的变化。当一个DOM遍历方法被调用时，新的元素集合推入到堆栈中。 如果还需要包含先前的元素集合，.andSelf() 可以提供帮助。

考虑一个页面，一个简单的列表就可以了：

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().andSelf()
  .css('background-color', 'red');

首先，初始选择位于第3项，初始化堆栈集合只包含这项。调用.nextAll() 后将第4和第5项推入堆栈。最后，调用.andSelf() 合并这两个组元素在一起，创建一个jQuery对象，指向所有三个项元素（按照文档中的顺序）：{[<li.third-item>,<li>,<li> ]}

例子:

.andSelf()方法导致以前遍历堆栈中的DOM元素被添加到当前组。  在第一个例子中，堆栈包含组的结果来自.find("p")。 在第二个例子中，.andSelf()将之前组的元素添加到堆栈中 - 在这种情况下（$("div.after-andSelf") - 到当前集合， 选择了两个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>andSelf()</code></strong></p>
  <div class="before-andself">
    <p>First Paragraph</p>
    <p>Second Paragraph</p>
  </div>
</div>
<div class="right">
  <p><strong>After <code>andSelf()</code></strong></p>
  <div class="after-andself">
    <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-andself").find("p").addClass("background");
 
// Second Example
$("div.after-andself").find("p").andSelf().addClass("background");
</script>
 
</body>
</html>

Demo: