org.w3c.dom.html2

Interface HTMLOptionElement

All Superinterfaces:
Element, HTMLElement, Node
Known Implementing Classes:
DomHTMLOptionElement

public interface HTMLOptionElement
extends HTMLElement

A selectable choice. See the OPTION element definition in HTML 4.01.

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

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Method Summary

boolean
getDefaultSelected()
Represents the value of the HTML selected attribute.
boolean
getDisabled()
The control is unavailable in this context.
HTMLFormElement
getForm()
Returns the FORM element containing this control.
int
getIndex()
The index of this OPTION in its parent SELECT , starting from 0.
String
getLabel()
Option label for use in hierarchical menus.
boolean
getSelected()
Represents the current state of the corresponding form control, in an interactive user agent.
String
getText()
The text contained within the option element.
String
getValue()
The current form control value.
void
setDefaultSelected(boolean defaultSelected)
Represents the value of the HTML selected attribute.
void
setDisabled(boolean disabled)
The control is unavailable in this context.
void
setLabel(String label)
Option label for use in hierarchical menus.
void
setSelected(boolean selected)
Represents the current state of the corresponding form control, in an interactive user agent.
void
setValue(String value)
The current form control value.

Methods inherited from interface org.w3c.dom.Element

getAttribute, getAttributeNS, getAttributeNode, getAttributeNodeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNS, removeAttributeNode, setAttribute, setAttributeNS, setAttributeNode, setAttributeNodeNS, setIdAttribute, setIdAttributeNS, setIdAttributeNode

Methods inherited from interface org.w3c.dom.html2.HTMLElement

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Method Details

getDefaultSelected

public boolean getDefaultSelected()
Represents the value of the HTML selected attribute. The value of this attribute does not change if the state of the corresponding form control, in an interactive user agent, changes. See the selected attribute definition in HTML 4.01.

getDisabled

public boolean getDisabled()
The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.

getForm

public HTMLFormElement getForm()
Returns the FORM element containing this control. Returns null if this control is not within the context of a form.

getIndex

public int getIndex()
The index of this OPTION in its parent SELECT , starting from 0.

getLabel

public String getLabel()
Option label for use in hierarchical menus. See the label attribute definition in HTML 4.01.

getSelected

public boolean getSelected()
Represents the current state of the corresponding form control, in an interactive user agent. Changing this attribute changes the state of the form control, but does not change the value of the HTML selected attribute of the element.

getText

public String getText()
The text contained within the option element.

getValue

public String getValue()
The current form control value. See the value attribute definition in HTML 4.01.

setDefaultSelected

public void setDefaultSelected(boolean defaultSelected)
Represents the value of the HTML selected attribute. The value of this attribute does not change if the state of the corresponding form control, in an interactive user agent, changes. See the selected attribute definition in HTML 4.01.

setDisabled

public void setDisabled(boolean disabled)
The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.

setLabel

public void setLabel(String label)
Option label for use in hierarchical menus. See the label attribute definition in HTML 4.01.

setSelected

public void setSelected(boolean selected)
Represents the current state of the corresponding form control, in an interactive user agent. Changing this attribute changes the state of the form control, but does not change the value of the HTML selected attribute of the element.

setValue

public void setValue(String value)
The current form control value. See the value attribute definition in HTML 4.01.

* 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.