.siblings()
返回: jQuery
.siblings( [selector ] )
描述：获得匹配的元素集合中每个元素的同辈元素，视情况用一个选择器作筛选。
给定一个jQuery对象，代表了一个DOM元素的集合，.siblings()允许我们在DOM树中搜索遍这些元素的同辈元素，并根据匹配的元素构造一个新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" );
这次调用的结果是第一项、第二项、第四项和第五项有了红色背景。因为我们没有应用一个选择器表达式，所有的同辈元素毫不含糊地会成为对象的一部分。如果我们提供了一个选择器表达式，只有匹配这个表达式的元素才会包括在内。
原始元素并不包含在同辈元素中，当我们想要找到DOM树的特定层次中的所有元素时，记住这一点很重要。然而，如果原始集合包含了不止一个元素，它们可能相互是同辈元素，因此两个都会被找到。如果你需要一个同辈元素的排除列表，请使用$collection.siblings().not($collection)。
示例
查找3个列表中，所有黄色<li>元素的独一无二的的同辈元素（如果条件适当的话，还包括其它黄色<li>元素）。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>siblings demo</title>
<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://code.jquery.com/jquery-1.10.2.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>
演示结果
查找每个含有 "selected"样式类的div的所有同辈元素。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>siblings demo</title> <script src="https://code.jquery.com/jquery-1.10.2.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>
演示结果