public interface HTMLSelectElement extends HTMLElement
See also the Document Object Model (DOM) Level 2 HTML Specification.
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
Modifier and Type | Method and Description |
---|---|
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.
|
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS
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
String getType()
true
and the string
"select-one" when false
.int getSelectedIndex()
void setSelectedIndex(int selectedIndex)
String getValue()
void setValue(String value)
int getLength()
SELECT
.void setLength(int length) throws DOMException
SELECT
.DOMException
- NOT_SUPPORTED_ERR: if setting the length is not allowed by the
implementation.HTMLFormElement getForm()
FORM
element containing this control. Returns
null
if this control is not within the context of a
form.HTMLOptionsCollection getOptions()
OPTION
elements contained by this
element.boolean getDisabled()
void setDisabled(boolean disabled)
boolean getMultiple()
OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.void setMultiple(boolean multiple)
OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.String getName()
void setName(String name)
int getSize()
void setSize(int size)
int getTabIndex()
void setTabIndex(int tabIndex)
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.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.void blur()
void focus()