Object: HTMLOptionsCollection
The HTMLOptionsCollection object contains an array of HTMLOptionElement objects.
You can access an individual option element within a collection by its index position using HTMLOptionsCollection.item(), by its name or id attribute using HTMLOptionsCollection.namedItem(), or you can index the object directly. For example, if you create an instance of a HTMLOptionsCollection object called myHTMLOptions, then specifying
HTMLOptionsCollection properties
Property name |
Type |
Description |
Status |
Availability |
|---|---|---|---|---|
length |
int |
Returns the number of HTMLOptionElement objects contained in the list. |
read only |
4.6 or later |
HTMLOptionsCollection methods
Method: HTMLOptionsCollection.item()
Parameters
Parameter |
Type |
Description |
|---|---|---|
index |
int |
The index position of the node to be returned. Valid values are between 0 and HTMLOptionsCollection.length-1 inclusive. |
Method: HTMLOptionsCollection.namedItem()
The namedItem() method retrieves the node with the given name from the collection.
This method behaves differently depending on the document type:
If the document is an HTML document, this method first searches for a node with an id attribute that matches the given name, then searches for a node with a name attribute that matches the given name if no matching id attribute exists.
When searching HTML documents, this method is case insensitive.
If the document is an XHTML document, this method only searches for nodes with an id attribute that matches the given name.
When searching XHTML documents, this method is case sensitive.
Method: HTMLOptionsCollection.item()
Parameters
Parameter |
Type |
Description |
|---|---|---|
index |
int |
The index position of the node to be returned. Valid values are between 0 and HTMLOptionsCollection.length-1 inclusive. |
Method: HTMLOptionsCollection.namedItem()
The namedItem() method retrieves the node with the given name from the collection.
This method behaves differently depending on the document type:
If the document is an HTML document, this method first searches for a node with an id attribute that matches the given name, then searches for a node with a name attribute that matches the given name if no matching id attribute exists.
When searching HTML documents, this method is case insensitive.
If the document is an XHTML document, this method only searches for nodes with an id attribute that matches the given name.
When searching XHTML documents, this method is case sensitive.