# .siblings()

所属分类：遍历 > 树遍历 英文文档：.siblings()

## .siblings( [selector ] )返回: jQuery

描述: 获得匹配元素集合中每个元素的兄弟元素,可以提供一个可选的选择器。。

- #### 添加的版本: 1.0.siblings( [selector ] )

  - selector
    类型: Selector
    一个用于匹配元素的选择器字符串。

如果提供的jQuery代表了一组DOM元素，`.siblings()`方法通过这些元素组合传递到方法构造一个新的jQuery对象。

该方法选择性地接受同一类型选择器表达式，我们可以传递给`$()`函数。如果提供了选择器表达式，那么会先测试该元素是否满足匹配的选择器表达式。

考虑一个页上有一个简单的列表：

1 2 3 4 5 6 7 |
    <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>

如果我们在第三个项目开始之前，我们可以找到它的兄弟姐妹：

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

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

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

## 例子:

#### Example: 查找 3 个列表中，所有黄色 li 元素的独一无二的的兄弟元素 (如果条件适当的话，还包括其它黄色 li 元素)。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
    <!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://code.jquery.com/jquery-latest.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>

#### Demo:

#### Example: 查找每个含有 "selected" 样式的 div 的所有兄弟元素。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
    <!DOCTYPE html><html><head>  <script src="https://code.jquery.com/jquery-latest.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>

#### Demo: