|
||||||||
PREV CLASS NEXT CLASS | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection. See the SELECT 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_TYPE_NODE,
ELEMENT_NODE,
ENTITY_NODE,
ENTITY_REFERENCE_NODE,
NOTATION_NODE,
PROCESSING_INSTRUCTION_NODE,
TEXT_NODE |
Method Summary | |
void |
add(HTMLElement element,
HTMLElement before) Add a new element to the collection of OPTION elements for
this SELECT . |
void |
blur() Removes keyboard focus from this element. |
void |
focus() Gives keyboard focus to this element. |
boolean |
getDisabled() The control is unavailable in this context. |
HTMLFormElement |
getForm() Returns the FORM element containing this control. |
int |
getLength() The number of options in this SELECT . |
boolean |
getMultiple() If true, multiple OPTION elements may be selected in this
SELECT . |
java.lang.String |
getName() Form control or object name when submitted with a form. |
HTMLOptionsCollection |
getOptions() The collection of OPTION elements contained by this
element. |
int |
getSelectedIndex() The ordinal index of the selected option, starting from 0. |
int |
getSize() Number of visible rows. |
int |
getTabIndex() Index that represents the element's position in the tabbing order. |
java.lang.String |
getType() The type of this form control. |
java.lang.String |
getValue() The current form control value (i.e. |
void |
remove(int index) Remove an element from the collection of OPTION elements for
this SELECT . |
void |
setDisabled(boolean disabled) The control is unavailable in this context. |
void |
setLength(int length) The number of options in this SELECT . |
void |
setMultiple(boolean multiple) If true, multiple OPTION elements may be selected in this
SELECT . |
void |
setName(java.lang.String name) Form control or object name when submitted with a form. |
void |
setSelectedIndex(int selectedIndex) The ordinal index of the selected option, starting from 0. |
void |
setSize(int size) Number of visible rows. |
void |
setTabIndex(int tabIndex) Index that represents the element's position in the tabbing order. |
void |
setValue(java.lang.String value) The current form control value (i.e. |
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.Element |
getAttribute,
getAttributeNode,
getAttributeNodeNS,
getAttributeNS,
getElementsByTagName,
getElementsByTagNameNS, getTagName,
hasAttribute,
hasAttributeNS,
removeAttribute,
removeAttributeNode,
removeAttributeNS,
setAttribute,
setAttributeNode,
setAttributeNodeNS,
setAttributeNS |
Methods inherited from interface org.w3c.dom.Node |
appendChild,
cloneNode,
getAttributes,
getChildNodes,
getFirstChild,
getLastChild,
getLocalName,
getNamespaceURI,
getNextSibling,
getNodeName,
getNodeType,
getNodeValue,
getOwnerDocument,
getParentNode,
getPrefix,
getPreviousSibling,
hasAttributes,
hasChildNodes,
insertBefore,
isSupported, normalize,
removeChild,
replaceChild, setNodeValue,
setPrefix |
Method Detail |
public void add(HTMLElement element, HTMLElement before) throws DOMException
OPTION
elements for this SELECT
. This method is the
equivalent of the appendChild
method of the
Node
interface if the before
parameter is
null
. It is equivalent to the
insertBefore
method on the parent of
before
in all other cases. This method may have no
effect if the new element is not an OPTION
or an
OPTGROUP
.element
- The element to add.before
- The element to insert before, or
null
for the tail of the list.DOMException
- NOT_FOUND_ERR: Raised if before
is not a descendant
of the SELECT
element.public void blur()
public void focus()
public boolean getDisabled()
public HTMLFormElement getForm()
FORM
element containing this control.
Returns null
if this control is not within the context
of a form.public int getLength()
SELECT
.public boolean getMultiple()
OPTION
elements may be selected
in this SELECT
. See the
multiple attribute definition in HTML 4.01.public java.lang.String getName()
public HTMLOptionsCollection getOptions()
OPTION
elements contained by
this element.public int getSelectedIndex()
public int getSize()
public int getTabIndex()
public java.lang.String getType()
true
and the string "select-one" when false
.public java.lang.String getValue()
public void remove(int index)
OPTION
elements for this SELECT
. Does nothing if no element
has the given index.index
- The index of the item to remove, starting
from 0.public void setDisabled(boolean disabled)
public void setLength(int length) throws DOMException
SELECT
.DOMException
- NOT_SUPPORTED_ERR: if setting the length is not allowed by the
implementation.public void setMultiple(boolean multiple)
OPTION
elements may be selected
in this SELECT
. See the
multiple attribute definition in HTML 4.01.public void setName(java.lang.String name)
public void setSelectedIndex(int selectedIndex)
public void setSize(int size)
public void setTabIndex(int tabIndex)
public void setValue(java.lang.String value)
|
||||||||
PREV CLASS NEXT CLASS | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.