.eq()

.eq( index ) 返回: jQuery

描述: 获取匹配集合中指定的元素。

  • version added: 1.1.2.eq( index )

    index一个整数,指示元素基于0的位置。

  • version added: 1.4.eq( -index )

    -index一个整数,指示元素的位置,从集合中的最后一个元素开始倒数。

如果一个jQuery对象表示一个DOM元素的集合,.eq()方法从集合的一个元素中构造新的jQuery对象。所提供的索引标识这个集合中的元素的位置。

考虑一个页面上一个简单的列表:

  <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>

我们可以在列表项目上设置此方法:

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

此调用的结果是item 3的背景变成红色。请注意,提供的索引是从零开始的,并提及了元素在jQuery对象中的位置,不在DOM树中。

提供一个负数表示的元素的位置从集合中的末尾开始,而不是开头。例如:

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

这一次清单item 4变成了红色,因为这是从集合的末尾开始的第二个。

如果一个元素不能在指定的从零开始的索引值中被发现,该方法构造了一个空的新jQuery对象,length属性值是0。

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

在这里,列表项都没有变成了红色。

Example:

Turn the div with index 2 blue by adding an appropriate class.

<!DOCTYPE html>
<html>
<head>
  <style>
  div { width:60px; height:60px; margin:10px; float:left;
        border:2px solid blue; }
  .blue { background:blue; }
  </style>
  <script src="http://code.jquery.com/jquery-latest.min.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>

Demo:

jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)