siblings()
获得匹配元素集合中每个元素的兄弟元素,可以提供一个可选的选择器。。
.siblings([selector ])
- selector类型: Selector。一个用于匹配元素的选择器字符串。
如果提供的jQuery代表了一组DOM元素,.siblings()
方法通过这些元素组合传递到方法构造一个新的jQuery对象。
该方法选择性地接受同一类型选择器表达式,我们可以传递给$()
函数。如果提供了选择器表达式,那么会先测试该元素是否满足匹配的选择器表达式。
考虑一个页上有一个简单的列表:
<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>
如果我们在第三个项目开始之前,我们可以找到它的兄弟姐妹:
$('li.third-item').siblings().css('background-color', 'red');
- list item 1
- list item 2
- list item 3
- list item 4
- list item 5
该调用的结果是一个红色背景添加到1,2,4和5项。由于我们没有提供选择器表达式,因此所有的兄弟元素都是结果对象中的一部分。如果我们提供了选择器,那么只有上述四个列表项中,满足选择器的元素才会被包含在结果对象中。
原始元素并不会包含在结果对象中,当我们希望在DOM树中的某一个特定的层级找到的所有元素时,要特别注意这一点。然而,如果原始集合包含多个元素,他们可能是相互的兄弟元素,都将被发现。如果你需要只有兄弟元素的列表,请使用$collection.siblings().not($collection)
。
例子
查找 3 个列表中,所有黄色 li 元素的独一无二的的兄弟元素(如果条件适当的话,还包括其它黄色 li 元素)。
<!DOCTYPE html> <html> <head> <style> ul { float:left; margin:5px; font-size:16px; font-weight:bold; } p { color:blue; margin:10px 20px; font-size:16px; padding:5px; font-weight:bolder; } .hilite { background:yellow; } </style> <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script> </head> <body> <ul> <li>One</li> <li>Two</li> <li class="hilite">Three</li> <li>Four</li> </ul> <ul> <li>Five</li> <li>Six</li> <li>Seven</li> </ul> <ul> <li>Eight</li> <li class="hilite">Nine</li> <li>Ten</li> <li class="hilite">Eleven</li> </ul> <p>Unique siblings: <b></b></p> <script>var len = $(".hilite").siblings() .css("color", "red") .length; $("b").text(len); </script> </body> </html>
- One
- Two
- Three
- Four
- Five
- Six
- Seven
- Eight
- Nine
- Ten
- Eleven
Unique siblings:
查找每个含有"selected"样式的 div 的所有兄弟元素。
<!DOCTYPE html> <html> <head> <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script> </head> <body> <div><span>Hello</span></div> <p class="selected">Hello Again</p> <p>And Again</p> <script>$("p").siblings(".selected").css("background", "yellow");</script> </body> </html>
Hello
Hello Again
And Again