.siblings()

類別： 遍歷 > 樹狀遍歷

.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)。

範例

在 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.jquery.com/jquery-3.7.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>

示範

找出每個 div 中具有類別「選取」的所有兄弟項目。

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.jquery.com/jquery-3.7.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>

示範