elemental.html

Interface HTMLCollection

All Superinterfaces:

Indexable

All Known Subinterfaces:

HTMLOptionsCollection

All Known Implementing Classes:

JsHTMLCollection, JsHTMLOptionsCollection

public interface HTMLCollection
extends Indexable

HTMLCollection is an interface representing a generic collection of elements (in document order) and offers methods and properties for traversing the list.

Note: This interface is called HTMLCollection for historical reasons (before DOM4, collections implementing this interface could only have HTML elements as their items).

HTMLCollections in the HTML DOM are live; they are automatically updated when the underlying document is changed.

Method Summary

Modifier and Type	Method and Description
int	getLength() The number of items in the collection.
Node	item(int index) Returns the specific node at the given zero-based index into the list.
Node	namedItem(String name) Returns the specific node whose ID or, as a fallback, name matches the string specified by name.

Methods inherited from interface elemental.util.Indexable

at, length

Method Detail

getLength

int getLength()

The number of items in the collection. Read only.

item

Node item(int index)

Returns the specific node at the given zero-based index into the list. Returns null if the index is out of range.

namedItem

Node namedItem(String name)

Returns the specific node whose ID or, as a fallback, name matches the string specified by name. Matching by name is only done as a last resort, only in HTML, and only if the referenced element supports the name attribute. Returns null if no node exists by the given name.