.first()

分類： 遍歷 > 篩選

.first()傳回： jQuery

說明： 將匹配的元素集合縮小到集合中的第一個元素。

  • 新增版本： 1.4.first()

    • 此方法不接受任何參數。

假設有一個 jQuery 物件代表一組 DOM 元素，.first() 方法會從該組中的第一個元素建構一個新的 jQuery 物件。

考慮一個包含一個簡單清單的網頁

1
2
3
4
5
6
7
 
<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li>list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>

我們可以將此方法套用於清單項目集合

1
 
$( "li" ).first().css( "background-color", "red" );

此呼叫的結果會讓第一個項目有紅色背景。

範例

將清單中的第一個項目高亮。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>first demo</title>
  <style>
  .highlight {
    background-color: yellow;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<ul>
  <li>Look:</li>
  <li>This is some text in a list.</li>
  <li>This is a note about it.</li>
  <li>This is another note about it.</li>
</ul>
 
<script>
$( "ul li" ).first().addClass( "highlight" );
</script>
 
</body>
</html>

示範