|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | 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.
Field Summary |
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 . |
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. |
String |
getType()
The type of this form control. |
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(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(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 String getType()
true
and the string
"select-one" when false
.
public int getSelectedIndex()
public void setSelectedIndex(int selectedIndex)
public String getValue()
public void setValue(String value)
public int getLength()
SELECT
.
public void setLength(int length) throws DOMException
SELECT
.
DOMException
- NOT_SUPPORTED_ERR: if setting the length is not allowed by the
implementation.public HTMLFormElement getForm()
FORM
element containing this control. Returns
null
if this control is not within the context of a
form.
public HTMLOptionsCollection getOptions()
OPTION
elements contained by this
element.
public boolean getDisabled()
public void setDisabled(boolean disabled)
public boolean getMultiple()
OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.
public void setMultiple(boolean multiple)
OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.
public String getName()
public void setName(String name)
public int getSize()
public void setSize(int size)
public int getTabIndex()
public void setTabIndex(int tabIndex)
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 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 blur()
public void focus()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |