org.w3c.dom.html2
Interface HTMLOptionsCollection
An
HTMLOptionsCollection is a list of nodes representing HTML
option element. An individual node may be accessed by either ordinal
index or the node's
name or
id attributes.
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 HTML Specification.
int | getLength()- This attribute specifies the length or size of the list.
|
Node | item(int index)- This method retrieves a node specified by ordinal index.
|
Node | namedItem(String name)- This method retrieves a
Node using a name.
|
void | setLength(int length)- This attribute specifies the length or size of the list.
|
getLength
public int getLength()
This attribute specifies the length or size of the list.
item
public Node item(int index)
This method retrieves a node specified by ordinal index. Nodes are
numbered in tree order (depth-first traversal order).
index - The index of the node to be fetched. The index origin is
0.
- The
Node at the corresponding position upon
success. A value of null is returned if the index is
out of range.
namedItem
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. This method
is case insensitive in HTML documents and case sensitive in XHTML
documents.
name - The name of the Node to be fetched.
- 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.
setLength
public void setLength(int length)
throws DOMException This attribute specifies the length or size of the list.
DOMException - NOT_SUPPORTED_ERR: if setting the length is not allowed by the
implementation.
* Copyright (c) 2003 World Wide Web Consortium,
* (Massachusetts Institute of Technology, Institut National de
* Recherche en Informatique et en Automatique, Keio University). All
* Rights Reserved. This program is distributed under the W3C's Software
* Intellectual Property License. This program is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY; without even
* the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE.
* See W3C License http://www.w3.org/Consortium/Legal/ for more details.