HTMLCollection | NN 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 | ||
|
||
Objektspezifische Methoden | ||
|
||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||
Keine. |
length | NN 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 | |
|
|
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 | |
|
|
Zurückgegebener Wert | |
Referenz auf ein Elementobjekt. Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null. |