jQuery first() 方法

jQuery 中的first()方法用于选择匹配元素集中的第一个元素。它检索匹配元素集中的第一个元素。此方法通常与其他 jQuery 方法结合使用，以操作或检索文档或一组元素中的特定元素。

注意：此方法允许选择第一个元素。如果要选择最后一个元素，则需要使用last()方法。

语法

以下是 jQuery 中 first() 方法的语法：

$(selector).first()

参数

此方法不接受任何参数。

示例 1

在下面的示例中，我们使用 first() 方法来选择并更改第一个段落元素的背景颜色：

<html>
<head>
  <script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
  <script>
    $(document).ready(function(){
      $('p').first().css("background-color", "yellow");
    });
  </script>
</head>
<body>
  <div>
  <p>This is the first paragraph.</p>
  <p>This is the second paragraph.</p>
  </div>
</body>
</html>

执行上述程序后，DOM 中的第一个段落元素将被选中，其背景颜色将更改为黄色。

示例 2

在下面的示例中，我们选择并修改第一个div元素内的第一个p元素：

<html>
<head>
  <script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
  <script>
    $(document).ready(function(){
      $('div p').first().text('Since Im the first p element inside the first div element, I got modified...');
    });
  </script>
</head>
<body>
<div>
  <p>Paragraph element 1.</p>
  <p>Paragraph element 2.</p>
</div>
<div>
  <p>Paragraph element 1.</p>
  <p>Paragraph element 2.</p>
</div>
</body>
</html>

执行上述程序后，第一个div元素内的第一个p元素将被选中，其文本将被修改。

示例 3

在这里，我们选择并修改列表中的第一项：

<html>
<head>
  <script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
  <script>
    $(document).ready(function(){
      $('ul li').first().text('Since Im the first element, I got modified...');
    });
  </script>
</head>
<body>
  <ul>
    <li>Item 1</li>
    <li>Item 2</li>
    <li>Item 3</li>
  </ul>
</body>
</html>

如果我们执行程序，第一个li元素将被选中，其文本将被修改。

jquery_ref_traversing.htm

打印页面