HTMLAllCollection

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die HTMLAllCollection-Schnittstelle repräsentiert eine Sammlung aller Elemente des Dokuments, die nach Index (wie ein Array) und über das id eines Elements zugänglich ist. Sie wird von der Eigenschaft document.all zurückgegeben.

HTMLAllCollection hat eine sehr ähnliche Struktur wie HTMLCollection, aber es gibt viele subtile Verhaltensunterschiede – zum Beispiel kann HTMLAllCollection als Funktion aufgerufen werden, und ihre Methode item() kann mit einem String aufgerufen werden, der ein Element-id- oder name-Attribut repräsentiert.

Instanzeigenschaften

HTMLAllCollection.length Nur lesbar

Gibt die Anzahl der Elemente in der Sammlung zurück.

Instanzmethoden

HTMLAllCollection.item()

Gibt das Element zurück, das an dem angegebenen Index in der Sammlung positioniert ist, oder das Element mit dem angegebenen Wert für sein id- oder name-Attribut. Gibt null zurück, wenn kein Element gefunden wird.

HTMLAllCollection.namedItem()

Gibt das erste Element in der Sammlung zurück, dessen id oder name-Attribut mit dem gegebenen String-Namen übereinstimmt, oder null, wenn kein Element übereinstimmt.

Verwendung in JavaScript

Indizierter Zugriff

Zusätzlich zu den oben genannten Methoden können Elemente in einer HTMLAllCollection durch Ganzzahl-Indizes und Zeichenfolgeneigenschaften zugänglich gemacht werden. Das HTML-id-Attribut kann : und . als gültige Zeichen enthalten, was den Einsatz von Klammernotation zur Eigenschaftszugriff erforderlich macht. collection[i] entspricht collection.item(i), wobei i eine Ganzzahl, eine Zeichenkette, die eine Ganzzahl enthält, oder eine Zeichenkette, die ein id darstellt, sein kann.

Aufruf als Funktion

Ein HTMLAllCollection-Objekt ist aufrufbar. Wenn es ohne Argumente oder mit undefined aufgerufen wird, gibt es null zurück. Ansonsten gibt es denselben Wert wie die Methode item() bei denselben Argumenten zurück.

Spezielles Typumwandlungsverhalten

Aus historischen Gründen ist document.all ein Objekt, das auf folgende Weise wie undefined agiert:

Diese speziellen Verhaltensweisen stellen sicher, dass Code wie:

js
if (document.all) {
  // Assume that we are in IE; provide special logic
}
// Assume that we are in a modern browser

auch modernes Verhalten bietet, wenn er in einem Browser ausgeführt wird, der document.all aus Kompatibilitätsgründen implementiert.

In allen anderen Kontexten bleibt document.all jedoch ein Objekt. Zum Beispiel:

Spezifikationen

Specification
HTML Standard
# the-htmlallcollection-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch