HTMLCollectionNN 6 IE 5(Mac)/6(Win) DOM 1

Das HTMLCollection-Objekt ist im W3C-DOM eine abstrakte Darstellung einer Sammlung von HTML-Elementobjekten, die im selben Dokumentbaum existieren und dasselbe Tag aufweisen. Vom Standpunkt des W3C-DOM aus gesehen ist beispielsweise das document.images-Array ein HTMLCollection-Objekt. Bei allen Einträgen dieses Arrays handelt es sich um img-Elementobjektreferenzen. JavaScript behandelt solche Sammlungen als Arrays, auf deren Einträge über die Array-Schreibweise mithilfe der HTMLCollection-Eigenschaft length zugegriffen werden kann. Alternativ können Sie die beiden Methoden item( ) und namedItem( ) verwenden, um einen Eintrag in der Objektsammlung zu referenzieren. Alle Instanzen des HTMLCollection-Objekts (z. B. document.images) erben die Eigenschaft und die in der unten stehenden Liste aufgeführten Methoden vom abstrakten HTMLCollection-Objekt. Weitere Informationen finden Sie in den Abschnitten zu den einzelnen Instanzen in diesem Kapitel (anchors, applets, areas, cells, elements, forms, images, links, options, rows, tBodies sowie Nicht-W3C-DOM-Elementsammlungen all, children, embeds und frames).

 
Objektspezifische Eigenschaften
 
length
 
Objektspezifische Methoden
 
item( )namedItem( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften

Keine.

lengthNN 6 IE 5(Mac)/6(Win) DOM 1

Schreibgeschützt

Gibt die Anzahl von Elementen in der Sammlung zurück.

 
Beispiel
 
var howMany = document.myForm.elements.length;
 
Wert

Eine ganze Zahl.

item( )NN 6 IE 5(Mac)/6(Win) DOM 1

item(index)

Gibt ein Objekt aus der Samllung zurück, das dem mit dem Indexwert in der Quellcodereihenfolge übereinstimmenden Objekt entspricht. IE implementiert eine andere Variante dieser Methode für einige (aber nicht alle) seine Objektsammlungen mit einem optionalen zweiten Parameter.

 
Parameter
 
  • Eine auf Null basierende ganze Zahl, die dem angegebenen Element in der Quellcodereihenfolge entspricht.
 
Zurückgegebener Wert

Referenz auf ein Elementobjekt. Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null.

namedItem( )NN 6 IE 5(Mac)/6(Win) DOM 1

namedItem(IDOrName)

Gibt ein Objekt aus der Sammlung zurück, das dem mit dem Wert der Parameterzeichenfolge übereinstimmenden Objekt entspricht.

 
Parameter
 
  • Die Zeichenfolge, deren Wert mit dem Namen des gewünschten Filters übereinstimmt.
 
Zurückgegebener Wert

Referenz auf ein Elementobjekt. Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null.