• 首页
  • css3教程
  • html5教程
  • jQuery手册
  • php7教程
  • MySQL手册
  • apache手册
  • 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

    下篇:closest()