.children()

類別：遍歷 > 樹狀遍歷

.children( [selector ] )傳回：jQuery

說明：取得符合的元素集合中每個元素的子元素，可選擇使用選擇器進行篩選。

給定一個表示一組 DOM 元素的 jQuery 物件，.children() 方法允許我們在 DOM 樹中搜尋這些元素的子元素，並從匹配的元素建構一個新的 jQuery 物件。.children() 方法與 .find() 的不同在於，.children() 只會向下搜尋 DOM 樹的一層，而 .find() 可以向下搜尋多層，以選取後代元素（孫元素等）。另外請注意，與大多數 jQuery 方法一樣，.children() 不会傳回文字節點；若要取得所有子元素（包括文字和註解節點），請使用 .contents()。

.children() 方法可以選擇性地接受與我們傳遞給 $() 函數同類型的選取器表達式。如果提供選取器，將會透過測試元素是否與其匹配來篩選元素。

考慮一個包含基本巢狀清單的網頁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
<ul class="level-1">
  <li class="item-i">I</li>
  <li class="item-ii">II
    <ul class="level-2">
      <li class="item-a">A</li>
      <li class="item-b">B
        <ul class="level-3">
          <li class="item-1">1</li>
          <li class="item-2">2</li>
          <li class="item-3">3</li>
        </ul>
      </li>
      <li class="item-c">C</li>
    </ul>
  </li>
  <li class="item-iii">III</li>
</ul>

如果我們從第 2 層清單開始，我們可以找到其子元素

1
 
$( "ul.level-2" ).children().css( "background-color", "red" );

此呼叫的結果會在項目 A、B 和 C 後面顯示紅色背景。由於我們沒有提供選取器表達式，所有子元素都是傳回的 jQuery 物件的一部分。如果我們有提供選取器，則只有這三個項目中的匹配項目會包含在內。

範例

找出被按一下元素的所有子元素。

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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  div {
    width: 130px;
    height: 82px;
    margin: 10px;
    float: left;
    border: 1px solid blue;
    padding: 4px;
  }
  #container {
    width: auto;
    height: 105px;
    margin: 0;
    float: none;
    border: none;
  }
  .hilite {
    border-color: red;
  }
  #results {
    display: block;
    color: red;
  }
  p, span, em, a, b, button {
    border: 1px solid transparent;
  }
  p {
    margin: 10px;
  }
  span {
    color: blue;
  }
  input {
    width: 100px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div id="container">
  <div>
    <p>This <span>is the <em>way</em> we</span>
      write <em>the</em> demo,</p>
  </div>
 
  <div>
    <a href="#"><b>w</b>rit<b>e</b></a> the <span>demo,</span> <button>write
    the</button> demo,
  </div>
 
  <div>
    This <span>the way we <em>write</em> the <em>demo</em> so</span>
    <input type="text" value="early"> in
  </div>
 
  <p>
    <span>t</span>he <span>m</span>orning.
    <span id="results">Found <span>0</span> children in <span>TAG</span>.</span>
  </p>
</div>
 
<script>
$( "#container" ).on( "click", function( event ) {
  $( "*" ).removeClass( "hilite" );
  var kids = $( event.target ).children();
  var len = kids.addClass( "hilite" ).length;
 
  $( "#results span" ).first().text( len );
  $( "#results span" ).last().text( event.target.tagName );
 
  event.preventDefault();
} );
</script>
 
</body>
</html>

示範

找出每個 div 的所有子元素。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  span {
    color: blue;
  }
  p {
    margin: 5px 0;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>Hello (this is a paragraph)</p>
 
<div><span>Hello Again (this span is a child of the a div)</span></div>
<p>And <span>Again</span> (in another paragraph)</p>
 
<div>And One Last <span>Time</span> (most text directly in a div)</div>
 
<script>
$( "div" ).children().css( "border-bottom", "3px double red" );
</script>
 
</body>
</html>

示範

找出每個 div 中所有具有「已選取」類別的子元素。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  p {
    margin: 5px 0;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>
  <span>Hello</span>
  <p class="selected">Hello Again</p>
  <div class="selected">And Again</div>
  <p>And One Last Time</p>
</div>
 
<script>
$( "div" ).children( ".selected" ).css( "color", "blue" );
</script>
 
</body>
</html>

示範