.siblings()

.siblings( [ selector ] ) 官网原E文: jQuery

描述:获得匹配元素集合中每个元素的兄弟元素,选择性筛选的选择器。

  • version added: 1.0.siblings( [ 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');

该调用的结果是一个红色背景添加到1,。2,4和5项。由于我们没有提供一个选择的表达,所有的兄弟姐妹都是对象的一部分。如果我们提供的一个,其中只有四个匹配的项目将包括在内。

原始元素中不包括兄弟姐妹,要记住这一点很重要,当我们希望找到一个特定的DOM树级别的所有元素。

Examples:

Example: Find the unique siblings of all yellow li elements in the 3 lists (including other yellow li elements if appropriate).

<!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="http://code.jquery.com/jquery-latest.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>

Demo:

Example: Find all siblings with a class "selected" of each div.

<!DOCTYPE html>
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.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>

Demo:

jQuery 1.6 API 中文版Clove整理、修订