返回值:jQuerysiblings([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>

如果我们从 item 3 开始,我们可以向下面这样,查找它的兄弟元素:

$('li.third-item').siblings().css('background-color', 'red');

其结果是 item 1, item 2, item 4, 和 item 5 的背景色变成了红色。由于我们没有提供选择器表达式,因此所有的兄弟元素都是结果对象中的一部分。如果我们提供了选择器,那么只有上述四个列表项中,满足选择器的元素才会被包含在结果对象中。

原始元素并不会包含在结果对象中,要特别注意这一点,尤其是我们希望查找 DOM 中,在特殊层次上的所有元素时。

示例:

查找 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="jquery.min.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>
<head>
<script src="jquery.min.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>

演示: