addBack()
添加堆栈中元素集合到当前集合,一个选择性的过滤选择器。
.addBack([selector ])
- selector类型: Selector。一个字符串,其中包含一个选择器表达式,匹配当前元素集合不包括在内的元素
如上所述在讨论中的.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="https://www.lanmper.cn/static/js/jquery-3.5.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>
Before addBack()
First Paragraph
Second Paragraph
After addBack()
First Paragraph
Second Paragraph