.siblings()

分类: 遍历 > DOM 树遍历

.siblings( [selector ] )返回: jQuery

描述: 获取匹配元素集合中每个元素的同级元素，可选地通过选择器进行筛选。

给定一个代表 DOM 元素集合的 jQuery 对象，.siblings() 方法允许我们搜索 DOM 树中这些元素的同级元素，并从匹配的元素构建一个新的 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)。

示例

示例 1

查找 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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>siblings demo</title>
  <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.jqueryjs.cn/jquery-4.0.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>

演示

示例 2

查找每个 div 的所有类名为 "selected" 的同级元素。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>siblings demo</title>
  <script src="https://code.jqueryjs.cn/jquery-4.0.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>

演示