APIdia Launch Partner
Top Description Methods
org.w3c.dom.html

public Interface HTMLCollection

Imports
org.w3c.dom.Node
An HTMLCollection is a list of nodes. An individual node may be accessed by either ordinal index or the node'sname or id attributes.

Note

Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed.

See also the Document Object Model (DOM) Level 2 Specification.

Since
1.4, DOM Level 2

Method Summary

Modifier and TypeMethod and Description
public int
getLength()

This attribute specifies the length or size of the list.

public Node

Returns:

The Node at the corresponding position upon success. A value of null is returned if the index is out of range.
item(int
The index of the node to be fetched. The index origin is 0.
index)

This method retrieves a node specified by ordinal index.

public Node

Returns:

The Node with a name or id attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returns null .
namedItem(String
The name of the Node to be fetched.
name)

This method retrieves a Node using a name.

Method Detail

getLengthback to summary
public int getLength()

This attribute specifies the length or size of the list.

itemback to summary
public Node item(int index)

This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).

Parameters
index:int

The index of the node to be fetched. The index origin is 0.

Returns:Node

The Node at the corresponding position upon success. A value of null is returned if the index is out of range.

namedItemback to summary
public Node namedItem(String name)

This method retrieves a Node using a name. It first searches for a Node with a matching id attribute. If it doesn't find one, it then searches for a Node with a matching name attribute, but only on those elements that are allowed a name attribute.

Parameters
name:String

The name of the Node to be fetched.

Returns:Node

The Node with a name or id attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returns null .