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