.siblings()

分类: Traversing > Tree Traversal

.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树中的某一个特定的层级找到的所有元素时，要特别注意这一点。然而，如果原始集合包含多个元素，他们可能是相互的兄弟元素，都将被发现。如果你需要只有兄弟元素的列表，请使用$collection.siblings().not($collection)。

例子:

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="//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="//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: