jQuery-Traversal - eq() Method
Beispiel
Durch Hinzufügen der passenden Klasse an den div mit dem index 2, wird er blau gemacht:
$("body").find("div").eq(2).addClass("blue");
Definition und Verwendung
Die eq() Method reduziert den Element-Satz auf ein Element auf der angegebenen index-Stelle.
Syntax
.eq(index)
Parameter | Beschreibung |
---|---|
index |
Ganze Zahl, die die Position des Elements angibt (mindestens 0). Falls eine negative Zahl ist, wird von dem letzten Element der Sammlung zurückgezählt. |
Detaillierte Erklärung
Falls ein jQuery-Objekt bereitgestellt wird, das eine Sammlung von DOM-Elementen darstellt, verwendet die .eq() Method eine Element aus der Sammlung, um ein neues jQuery-Objekt zu erstellen. Der verwendete index-Parameter zeigt die Position des Elements in der Sammlung an.
Sehen Sie sich die folgende einfache Liste an:
<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>
Beispiel 1
Wir können diesen Method auf diese Liste von Projekten anwenden:
$('li').eq(2).css('background-color', 'red');
Das Ergebnis dieser Anruf ist, dass dem Element 3 ein roter Hintergrund zugewiesen wird. Beachten Sie, dass der index null-basiert ist und die Position des Elements im jQuery-Objekt referenziert, nicht im DOM-Baum.
Beispiel 2
Falls eine negative Zahl bereitgestellt wird, deutet dies auf die Position vom Ende der Sammlung beginnend hin, anstatt vom Anfang. Zum Beispiel:
$('li').eq(-2).css('background-color', 'red');
In diesem Fall wird der Hintergrund des Elements 4 rot, weil es der zweite von der Ende der Sammlung beginnende ist.
Beispiel 3
Falls der Element nicht durch den angegebenen index-Parameter gefunden werden kann, erstellt dieser Method eine jQuery-Objekt mit leerem Satz, die length-Eigenschaft beträgt 0.
$('li').eq(5).css('background-color', 'red');
Hier wird kein Listeneintrag rot, weil der .eq(5) angegebene sechste Listeneintrag ist.