Método eq() de Navegación jQuery
Ejemplo
Al agregar la clase adecuada al div de index 2, se convierte en azul:
$("body").find("div").eq(2).addClass("blue");
Definición y Uso
El método eq() reduce el conjunto de elementos coincidentes al valor especificado en el index.
Sintaxis
.eq(index)
Parámetro | Descripción |
---|---|
index |
Entero, indica la posición del elemento (el mínimo es 0). Si es negativo, se cuenta hacia atrás desde el último elemento del conjunto. |
Descripción Detallada
Si se proporciona un objeto jQuery que representa una colección de elementos DOM, el método .eq() construirá un nuevo objeto jQuery con un elemento de la colección. El parámetro index indica la posición del elemento en la colección.
Mira la lista simple siguiente:
<ul> <li>elemento de lista 1</li> <li>elemento de lista 2</li> <li>elemento de lista 3</li> <li>elemento de lista 4</li> <li>elemento de lista 5</li> </ul>
Ejemplo 1
Podemos aplicar este método a este conjunto de elementos de lista:
$('li').eq(2).css('background-color', 'red');
El resultado de esta llamada es establecer el fondo del proyecto 3 en rojo. Nota que el index se basa en cero y se refiere a la posición del elemento en el objeto jQuery, no en el árbol DOM.
Ejemplo 2
Si se proporciona un número negativo, indica la posición desde el final del conjunto en lugar de comenzar desde el principio. Por ejemplo:
$('li').eq(-2).css('background-color', 'red');
Esta vez, el fondo del proyecto 4 se convierte en rojo, porque es el segundo desde el final del conjunto.
Ejemplo 3
Si no se puede encontrar el elemento según el parámetro de index especificado, este método construye un objeto jQuery con un conjunto vacío, la propiedad length es 0.
$('li').eq(5).css('background-color', 'red');
Aquí, ningún elemento de lista se convertirá en rojo, porque .eq(5) indica el sexto elemento de lista.