HTML DOM
The HTMLSelectElement interface represents a select HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface.
Instance properties
This interface inherits the properties of HTMLElement, and of Element and Node.
- HTMLSelectElement.autocomplete
- : A string value reflecting the
autocomplete, which indicates whether the value of the control can be automatically completed by the browser.
- : A string value reflecting the
- HTMLSelectElement.disabled
- : A boolean value reflecting the
disabledHTML attribute, which indicates whether the control is disabled. If it is disabled, it does not accept clicks.
- : A boolean value reflecting the
- HTMLSelectElement.form
- : An HTMLFormElement referencing the form that this element is associated with. If the element is not associated with of a form element, then it returns
null.
- : An HTMLFormElement referencing the form that this element is associated with. If the element is not associated with of a form element, then it returns
- HTMLSelectElement.labels
- : A NodeList of label elements associated with the element.
- HTMLSelectElement.length
- : An
unsigned longThe number of option elements in thisselectelement.
- : An
- HTMLSelectElement.multiple
- : A boolean value reflecting the
multipleHTML attribute, which indicates whether multiple items can be selected.
- : A boolean value reflecting the
- HTMLSelectElement.name
- : A string reflecting the
nameHTML attribute, containing the name of this control used by servers and DOM search functions.
- : A string reflecting the
- HTMLSelectElement.options
- : An HTMLOptionsCollection representing the set of option (HTMLOptionElement) elements contained by this element.
- HTMLSelectElement.required
- : A boolean value reflecting the
requiredHTML attribute, which indicates whether the user is required to select a value before submitting the form.
- : A boolean value reflecting the
- HTMLSelectElement.selectedIndex
- : A
longreflecting the index of the first selected option element. The value-1indicates no element is selected.
- : A
- HTMLSelectElement.selectedOptions
- : An HTMLCollection representing the set of option elements that are selected.
- HTMLSelectElement.size
- : A
longreflecting thesizeHTML attribute, which contains the number of visible items in the control. The default is 1, unlessmultipleistrue, in which case it is 4.
- : A
- HTMLSelectElement.type
- : A string representing the form control's type. When
multipleistrue, it returns"select-multiple"; otherwise, it returns"select-one".
- : A string representing the form control's type. When
- HTMLSelectElement.validationMessage
- : A string representing a localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation (
willValidateis false), or it satisfies its constraints.
- : A string representing a localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation (
- HTMLSelectElement.validity
- : A ValidityState reflecting the validity state that this control is in.
- HTMLSelectElement.value
- : A string reflecting the value of the form control. Returns the
valueproperty of the first selected option element if there is one, otherwise the empty string.
- : A string reflecting the value of the form control. Returns the
- HTMLSelectElement.willValidate
- : A boolean value that indicates whether the button is a candidate for constraint validation. It is
falseif any conditions bar it from constraint validation.
- : A boolean value that indicates whether the button is a candidate for constraint validation. It is
Instance methods
This interface inherits the methods of HTMLElement, and of Element and Node.
- HTMLSelectElement.add()
- : Adds an element to the collection of
optionelements for thisselectelement.
- : Adds an element to the collection of
- HTMLSelectElement.checkValidity()
- : Checks whether the element has any constraints and whether it satisfies them. If the element fails its constraints, the browser fires a cancelable HTMLInputElement/invalid_event event at the element (and returns
false).
- : Checks whether the element has any constraints and whether it satisfies them. If the element fails its constraints, the browser fires a cancelable HTMLInputElement/invalid_event event at the element (and returns
- HTMLSelectElement.item()
- : Gets an item from the options collection for this select element. You can also access an item by specifying the index in square brackets or parentheses, without calling this method explicitly.
- HTMLSelectElement.namedItem()
- : Gets the item in the options collection with the specified name. The name string can match either the
idor thenameattribute of an option node. You can also access an item by specifying the name in square brackets or parentheses, without calling this method explicitly.
- : Gets the item in the options collection with the specified name. The name string can match either the
- HTMLSelectElement.remove()
- : Removes the element at the specified index from the options collection for this
selectelement.
- : Removes the element at the specified index from the options collection for this
- HTMLSelectElement.reportValidity()
- : This method reports the problems with the constraints on the element, if any, to the user. If there are problems, it fires a cancelable HTMLInputElement/invalid_event event at the element, and returns
false; if there are no problems, it returnstrue.
- : This method reports the problems with the constraints on the element, if any, to the user. If there are problems, it fires a cancelable HTMLInputElement/invalid_event event at the element, and returns
- HTMLSelectElement.setCustomValidity()
- : Sets the custom validity message for the selection element to the specified message. Use the empty string to indicate that the element does not have a custom validity error.
- HTMLSelectElement.showPicker()
- : Shows the option picker.
Events
This interface inherits the events of HTMLElement, and of Element and Node.
Listen to these events using EventTarget/addEventListener or by assigning an event listener to the oneventname property of this interface:
- HTMLElement/change_event event
- : Fires when the user selects an option.
- Element/input_event event
- : Fires when the
valueof an input, select, or textarea element has been changed.
- : Fires when the
Example
Get information about the selected option
/* assuming we have the following HTML
<select id='s'>
<option>First</option>
<option selected>Second</option>
<option>Third</option>
</select>
*/
const select = document.getElementById("s");
// return the index of the selected option
console.log(select.selectedIndex); // 1
// return the value of the selected option
console.log(select.options[select.selectedIndex].value); // Second
A better way to track changes to the user's selection is to watch for the HTMLElement/change_event event to occur on the <select>. This will tell you when the value changes, and you can then update anything you need to. See the example provided in the documentation for the change event for details.
Specifications
Browser compatibility
See also
- The select HTML element, which implements this interface.
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
