HTMLAllCollection

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die HTMLAllCollection-Schnittstelle repräsentiert eine Sammlung von allen Elementen des Dokuments, die über einen Index (wie ein Array) und über die id des Elements zugänglich sind. Sie wird von der document.all-Eigenschaft 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 seine item()-Methode kann mit einem String aufgerufen werden, der dem id- oder name-Attribut eines Elements entspricht.

Instanz-Eigenschaften

HTMLAllCollection.length Schreibgeschützt

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

Instanz-Methoden

HTMLAllCollection.item()

Gibt das Element zurück, das sich an der angegebenen Stelle in der Sammlung befindet, 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 angegebenen String-Namen übereinstimmt, oder null, wenn kein Element übereinstimmt.

Verwendung in JavaScript

Indexierter Zugriff

Zusätzlich zu den oben genannten Methoden können Elemente in einer HTMLAllCollection durch Ganzzahl-Indizes und String-Eigenschaftsnamen zugegriffen werden. Das HTML-id-Attribut kann : und . als gültige Zeichen enthalten, was die Verwendung der Klammernotation für den Eigenschaftszugriff erforderlich macht. collection[i] ist gleichbedeutend mit collection.item(i), wobei i eine Ganzzahl, ein String, der eine Ganzzahl enthält, oder ein String, der eine 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. Andernfalls gibt es denselben Wert wie die item()-Methode zurück, wenn dieselben Argumente übergeben werden.

Spezielles Typkonvertierungsverhalten

Aus historischen Gründen ist document.all ein Objekt, das sich in folgenden Aspekten wie undefined verhält:

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 dann modernes Verhalten liefert, wenn der Code 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
# the-htmlallcollection-interface

Browser-Kompatibilität

Siehe auch