Método eq() da iteração do jQuery
Exemplo
Ao adicionar a classe apropriada ao div no índice 2, torna-o azul:
$("body").find("div").eq(2).addClass("blue");
Definição e uso
O método eq() reduz o conjunto de elementos correspondentes ao elemento no índice especificado.
Sintaxe
.eq(index)
| Parâmetro | Descrição |
|---|---|
| index |
Inteiro, indica a posição do elemento (o menor é 0). Se for negativo, conta de trás a partir do último elemento do conjunto. |
Explicação detalhada
Se fornecer um objeto jQuery que representa uma coleção de elementos DOM, o método .eq() constrói um novo objeto jQuery com um elemento da coleção. O parâmetro index indica a posição do elemento na coleção.
Veja a lista simples abaixo:
<ul> <li>item da lista 1</li> <li>item da lista 2</li> <li>item da lista 3</li> <li>item da lista 4</li> <li>item da lista 5</li> </ul>
Exemplo 1
Podemos aplicar este método a esse conjunto de itens da lista:
$('li').eq(2).css('background-color', 'red');
O resultado dessa chamada é definir o fundo do item 3 como vermelho. Note que o index é baseado em zero e se refere à posição do elemento no objeto jQuery, não na árvore DOM.
Exemplo 2
Se fornecer um número negativo, indica a posição a partir do final do conjunto, não do início. Por exemplo:
$('li').eq(-2).css('background-color', 'red');
Nesta vez, o fundo do item 4 se torna vermelho, pois ele é o segundo a partir do final do conjunto.
Exemplo 3
Se não for possível encontrar o elemento com base no parâmetro index especificado, este método constrói um objeto jQuery com um conjunto vazio, cujo atributo length é 0.
$('li').eq(5).css('background-color', 'red');
Aqui, nenhum item da lista se tornará vermelho, pois o .eq(5) indica o sexto item da lista.
