概述 .addBack( [selector ] )
返回值:jQuery
描述:添加堆栈中元素集合到当前集合,一个选择性的过滤选择器。
如上所述在讨论中的.end()
, jQuery对象维护一个堆栈内部来跟踪匹配的元素集合的变化。当一个DOM遍历方法被调用时,新的元素集合推入到堆栈中。 如果还需要包含先前的元素集合,.addBack()
可以提供帮助。
考虑一个页面,一个简单的列表就可以了:
<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项是一个红色的背景:
$('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和其封闭的段落。
<!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="http://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>