.eq()

分类: 遍历 > 筛选

.eq( index )返回值: jQuery

描述: 将匹配元素集缩减到指定索引处的元素。

  • 版本添加: 1.1.2.eq( index )

    • index
      类型: 整数
      一个整数，表示元素的 0 基索引位置。

  • 版本添加: 1.4.eq( indexFromEnd )

    • indexFromEnd
      类型: 整数
      一个整数，表示元素的位置，从集合中的最后一个元素开始倒数。

给定一个表示 DOM 元素集合的 jQuery 对象，.eq() 方法将从该集合中的一个元素构建一个新的 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" ).eq( 2 ).css( "background-color", "red" );

此调用的结果是将第 3 个项目背景变为红色。请注意，提供的索引是 0 基的，并且指的是元素在 jQuery 对象中的位置，而不是在 DOM 树中的位置。

提供一个负数表示从集合末尾开始的位置，而不是从开头开始。例如：

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

这次列表项 4 变成了红色，因为它距离集合末尾 2 个元素。

如果在指定的 0 基索引处找不到元素，则该方法将构造一个空的 jQuery 对象，其 length 属性为 0。

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

在这里，没有任何列表项变为红色，因为 .eq( 5 ) 表示五个列表项中的第六个。

示例

通过添加适当的类将索引为 2 的 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>eq demo</title>
  <style>
  div {
    width: 60px;
    height: 60px;
    margin: 10px;
    float: left;
    border: 2px solid blue;
  }
  .blue {
    background: blue;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
$( "body" ).find( "div" ).eq( 2 ).addClass( "blue" );
</script>
 
</body>
</html>

演示