Object: HTMLCollection

Help Center

Search This Document

Availability

BlackBerry® Device Software version 4.6 or later

The HTMLCollection object is an array that contains an ordered collection of nodes. HTMLCollection objects are automatically updated when the underlying document is changed.

You can access an individual node within a collection by its index position using HTMLCollection.item(), by its name or id attribute using HTMLCollection.namedItem(), or you can index the object directly. For example, if you create an instance of a HTMLCollection object called myHTMLNodes, then specifying

myHTMLNodes.item(2)

myHTMLNodes.namedItem(“item”)

is equivalent to specifying

myHTMLNodes[2]

myHTMLNodes[“item”]

HTMLCollection properties

Property name	Type	Description	Status	Support level	Availability
`length`	int	Returns the number of nodes in the list.	read only	DOM 2 HTML	4.6 or later

HTMLCollection methods

Method name	Description	Support level	Availability
`item()`	Returns the node at the specified index.	DOM 2 HTML	4.6 or later
`namedItem()`	Retrieves the node with the given name from the collection.	DOM 2 HTML	4.6 or later

Next topic: Object: HTMLDListElement

Previous topic: HTMLCanvasElement methods

Was this information helpful? Send us your comments.

Global Navigation

Help Center

Local Navigation