OpenJDK 27 · org.w3c.dom.html.HTMLSelectElement · APIdia, the JavaDoc alternative

Method Summary

Modifier and Type	Method and Description
public void	add(HTMLElement The element to add. element, HTMLElement The element to insert before, or `null` for the tail of the list. before) Add a new element to the collection of `OPTION` elements for this `SELECT` .
public void	blur() Removes keyboard focus from this element.
public void	focus() Gives keyboard focus to this element.
public boolean	getDisabled() The control is unavailable in this context.
public HTMLFormElement	getForm() Returns the `FORM` element containing this control.
public int	getLength() The number of options in this `SELECT` .
public boolean	getMultiple() If true, multiple `OPTION` elements may be selected in this `SELECT` .
public String	getName() Form control or object name when submitted with a form.
public HTMLCollection	getOptions() The collection of `OPTION` elements contained by this element.
public int	getSelectedIndex() The ordinal index of the selected option, starting from 0.
public int	getSize() Number of visible rows.
public int	getTabIndex() Index that represents the element's position in the tabbing order.
public String	getType() The type of this form control.
public String	getValue() The current form control value.
public void	remove(int The index of the item to remove, starting from 0. index) Remove an element from the collection of `OPTION` elements for this `SELECT` .
public void	setDisabled(boolean disabled)
public void	setMultiple(boolean multiple)
public void	setName(String name)
public void	setSelectedIndex(int selectedIndex)
public void	setSize(int size)
public void	setTabIndex(int tabIndex)
public void	setValue(String value)

Inherited from org.w3c.dom.html.HTMLElement:: getClassName getDir getId getLang getTitle setClassName setDir setId setLang setTitle

Method Detail

add back to summary

add	back to summary
public void add(HTMLElement element, HTMLElement before) throws DOMException Add a new element to the collection of `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. Parameters element:HTMLElement The element to add. before:HTMLElement The element to insert before, or `null` for the tail of the list. Exceptions DOMException: NOT_FOUND_ERR: Raised if `before` is not a descendant of the `SELECT` element.

public void add(HTMLElement element, HTMLElement before) throws DOMException

Add a new element to the collection of 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.

Parameters

element:HTMLElement: The element to add.
before:HTMLElement: The element to insert before, or null for the tail of the list.

Exceptions

DOMException:: NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element.

blur	back to summary
public void blur() Removes keyboard focus from this element.

focus	back to summary
public void focus() Gives keyboard focus to this element.

getDisabled	back to summary
public boolean getDisabled() The control is unavailable in this context. See the disabled attribute definition in HTML 4.0.

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

getLength	back to summary
public int getLength() The number of options in this `SELECT` .

getMultiple	back to summary
public boolean getMultiple() If true, multiple `OPTION` elements may be selected in this `SELECT` . See the multiple attribute definition in HTML 4.0.

getName	back to summary
public String getName() Form control or object name when submitted with a form. See the name attribute definition in HTML 4.0.

getOptions	back to summary
public HTMLCollection getOptions() The collection of `OPTION` elements contained by this element.

getSelectedIndex	back to summary
public int getSelectedIndex() The ordinal index of the selected option, starting from 0. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.

getSize	back to summary
public int getSize() Number of visible rows. See the size attribute definition in HTML 4.0.

getTabIndex	back to summary
public int getTabIndex() Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.0.

getType	back to summary
public String getType() The type of this form control. This is the string "select-multiple" when the multiple attribute is `true` and the string "select-one" when `false` .

getValue	back to summary
public String getValue() The current form control value.

remove back to summary

remove	back to summary
public void remove(int index) Remove an element from the collection of `OPTION` elements for this `SELECT` . Does nothing if no element has the given index. Parameters index:int The index of the item to remove, starting from 0.

public void remove(int index)

Remove an element from the collection of OPTION elements for this SELECT . Does nothing if no element has the given index.

Parameters

index:int: The index of the item to remove, starting from 0.

setDisabled	back to summary
public void setDisabled(boolean disabled)

setMultiple	back to summary
public void setMultiple(boolean multiple)

setName	back to summary
public void setName(String name)

setSelectedIndex	back to summary
public void setSelectedIndex(int selectedIndex)

setSize	back to summary
public void setSize(int size)

setTabIndex	back to summary
public void setTabIndex(int tabIndex)

setValue	back to summary
public void setValue(String value)

public Interface HTMLSelectElement

Method Summary

Method Detail