HTMLAllCollection

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie mglicherweise noch untersttzen, knnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Krze entfernt werden oder nur noch aus Kompatibilittsgrnden bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls mglich; siehe die Kompatibilittstabelle am Ende dieser Seite, um Ihre Entscheidung zu untersttzen. Beachten Sie, dass diese Funktion jederzeit aufhren knnte zu funktionieren.

Die HTMLAllCollection-Schnittstelle reprsentiert eine Sammlung von allen Elementen des Dokuments, die ber einen Index (wie ein Array) und ber die id des Elements zugnglich sind. Sie wird von der document.all-Eigenschaft zurckgegeben.

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 Schreibgeschtzt: Gibt die Anzahl der Elemente in der Sammlung zurck.

Instanz-Methoden

HTMLAllCollection.item(): Gibt das Element zurck, das sich an der angegebenen Stelle in der Sammlung befindet, oder das Element mit dem angegebenen Wert fr sein id- oder name-Attribut. Gibt null zurck, wenn kein Element gefunden wird.
HTMLAllCollection.namedItem(): Gibt das erste Element in der Sammlung zurck, dessen id- oder name-Attribut mit dem angegebenen String-Namen bereinstimmt, oder null, wenn kein Element bereinstimmt.

Verwendung in JavaScript

Indexierter Zugriff

Zustzlich zu den oben genannten Methoden knnen Elemente in einer HTMLAllCollection durch Ganzzahl-Indizes und String-Eigenschaftsnamen zugegriffen werden. Das HTML-id-Attribut kann : und . als gltige Zeichen enthalten, was die Verwendung der Klammernotation fr den Eigenschaftszugriff erforderlich macht. collection[i] ist gleichbedeutend mit collection.item(i), wobei i eine Ganzzahl, ein String, der eine Ganzzahl enthlt, 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 zurck. Andernfalls gibt es denselben Wert wie die item()-Methode zurck, wenn dieselben Argumente bergeben werden.

Spezielles Typkonvertierungsverhalten

Aus historischen Grnden ist document.all ein Objekt, das sich in folgenden Aspekten wie undefined verhlt:

Es ist nicht streng gleich zu undefined und null.
Es ist falsy in booleschen Kontexten.
Sein typeof ist "undefined".

Diese speziellen Verhaltensweisen stellen sicher, dass Code wie:

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 ausgefhrt wird, der document.all aus Kompatibilittsgrnden implementiert.

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

Es ist nicht streng gleich zu undefined oder null.
Wenn es auf der linken Seite des Nullish Coalescing Operators (??) oder des Optional Chaining Operators (?.) verwendet wird, wird der Ausdruck nicht vorzeitig abgebrochen.

Spezifikationen

Spezifikation
HTML # the-htmlallcollection-interface

Browser-Kompatibilitt

Siehe auch

HTMLCollection

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

Document Object Model (DOM)
HTMLAllCollection
Instanzeigenschaften
1. length
Instanzmethoden
1. item()
2. namedItem()
Verwandte Seiten fr DOM
Anleitungen
1. Anatomie des DOM
2. Attributreflexion
3. Auswahl und Traversierung im DOM-Baum
4. Erstellen und Aktualisieren des DOM-Baums
5. Arbeiten mit Ereignissen