Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

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.

Properties

This interface inherits the properties of HTMLElement, and of Element and Node.

HTMLSelectElement.autofocus
A Boolean reflecting the autofocus HTML attribute, which indicates whether the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form-associated element in a document can have this attribute specified.
HTMLSelectElement.disabled
A Boolean reflecting the disabled HTML attribute, which indicates whether the control is disabled. If it is disabled, it does not accept clicks.
HTMLSelectElement.formRead only
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.
HTMLSelectElement.labelsRead only
A NodeList of <label> elements associated with the element.
HTMLSelectElement.length
An unsigned long The number of <option> elements in this select element.
HTMLSelectElement.multiple
A Boolean reflecting the multiple HTML attribute, which indicates whether multiple items can be selected.
HTMLSelectElement.name
A DOMString reflecting the name HTML attribute, containing the name of this control used by servers and DOM search functions.
HTMLSelectElement.optionsRead only
An HTMLOptionsCollection representing the set of <option> elements contained by this element.
HTMLSelectElement.required
A Boolean reflecting the required HTML attribute, which indicates whether the user is required to select a value before submitting the form.
HTMLSelectElement.selectedIndex
A long reflecting the index of the first selected <option> element. The value -1 indicates no element is selected.
HTMLSelectElement.selectedOptionsRead only
An HTMLCollection representing the set of <option> elements that are selected.
HTMLSelectElement.size
A long reflecting the size HTML attribute, which contains the number of visible items in the control. The default is 1, unless multiple is true, in which case it is 4.
HTMLSelectElement.typeRead only
A DOMString represeting the form control's type. When multiple is true, it returns "select-multiple"; otherwise, it returns "select-one".
HTMLSelectElement.validationMessageRead only
A DOMString 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 (willValidate is false), or it satisfies its constraints.
HTMLSelectElement.validityRead only
A ValidityState reflecting the validity state that this control is in.
HTMLSelectElement.value
A DOMString reflecting the value of the form control (the first selected option). Returns the value attribute of the option element or if it is missing, the text attribute.
HTMLSelectElement.willValidateRead only
A Boolean that indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation.

Methods

This interface inherits the methods of HTMLElement, and of Element and Node.

HTMLSelectElement.add()
Adds an element to the collection of option elements for this select element.
HTMLSelectElement.blur()
Removes input focus from this element. This method is now implemented on HTMLElement.
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 invalid event at the element (and returns false).
HTMLSelectElement.focus()
Gives input focus to this element. This method is now implemented on HTMLElement.
HTMLSelectElement.item()
Gets an item from the options collection for this <select> element. You can also access an item by specifying the index in array-style 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 id or the name attribute of an option node. You can also access an item by specifying the name in array-style brackets or parentheses, without calling this method explicitly.
HTMLSelectElement.remove()
Removes the element at the specified index from the options collection for this select element.
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.

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>
*/

var 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 change 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

Specification Status Comment
HTML Living Standard
La definición de 'HTMLSelectElement' en esta especificación.
Living Standard Since the latest snapshot, HTML5, it adds the autocomplete property and the reportValidity() method.
HTML5
La definición de 'HTMLSelectElement' en esta especificación.
Recommendation Is a snapshot of HTML Living Standard.
It adds the autofocus, form, required, labels, selectedOptions, willValidate, validity and validationMessage properties.
The tabindex property and the blur() and focus() methods have been moved to HTMLElement.
The methods item(), namedItem(), checkValidity() and setCustomValidity().
Document Object Model (DOM) Level 2 HTML Specification
La definición de 'HTMLSelectElement' en esta especificación.
Obsolete options now returns an HTMLOptionsCollection.
length now returns an unsigned long.
Document Object Model (DOM) Level 1 Specification
La definición de 'HTMLSelectElement' en esta especificación.
Obsolete Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Soporte básicoChrome Soporte completo 1Edge Soporte completo SiFirefox Soporte completo 2
Notas
Soporte completo 2
Notas
Notas You should watch for change events on <select> instead of watching <option> elements for events. See bug 1090602 and Multiprocess Firefox Web content compatibility for details.
IE Soporte completo 1Opera Soporte completo 2Safari Soporte completo 1WebView Android Soporte completo 1Chrome Android Soporte completo 18Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo 1Safari iOS ? Samsung Internet Android ?
autofocusChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Soporte completo 10Opera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Sin soporte NoSafari iOS Sin soporte NoSamsung Internet Android ?
disabledChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Soporte completo 9Opera Soporte completo 9Safari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo SiOpera Android ? Safari iOS Soporte completo SiSamsung Internet Android ?
formChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Soporte completo SiOpera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo SiOpera Android Soporte completo SiSafari iOS Soporte completo SiSamsung Internet Android ?
labelsChrome Soporte completo 14Edge Sin soporte NoFirefox Soporte completo 56IE Sin soporte NoOpera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile Sin soporte NoFirefox Android Soporte completo 56Opera Android ? Safari iOS ? Samsung Internet Android ?
lengthChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
multipleChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
nameChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
optionsChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
requiredChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
selectedIndexChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
selectedOptionsChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Sin soporte NoOpera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo SiOpera Android ? Safari iOS ? Samsung Internet Android ?
sizeChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
typeChrome Soporte completo 1Edge Soporte completo SiFirefox Soporte completo 1IE Soporte completo 1Opera Soporte completo 2Safari Soporte completo 1WebView Android Soporte completo 1Chrome Android Soporte completo 18Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo 1Safari iOS Soporte completo 1Samsung Internet Android ?
validationMessageChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android ? Chrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android ? Safari iOS ? Samsung Internet Android ?
validityChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android ? Chrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android ? Safari iOS ? Samsung Internet Android ?
valueChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
willValidateChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android ? Chrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android ? Safari iOS ? Samsung Internet Android ?
addChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo SiOpera Android Soporte completo SiSafari iOS ? Samsung Internet Android ?
blurChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
checkValidityChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo 10Opera Soporte completo SiSafari Soporte completo SiWebView Android ? Chrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android ? Safari iOS Soporte completo SiSamsung Internet Android ?
focusChrome ? Edge ? Firefox ? IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android ?
itemChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android Soporte completo SiChrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo SiSafari iOS ? Samsung Internet Android ?
namedItemChrome Soporte completo SiEdge Soporte completo Si
Notas
Soporte completo Si
Notas
Notas namedItem does not appear to take the name attribute into account (only the id attribute) on Internet Explorer and Edge. There is a bug report to Microsoft about this.
Firefox Soporte completo 4IE Soporte completo Si
Notas
Soporte completo Si
Notas
Notas namedItem does not appear to take the name attribute into account (only the id attribute) on Internet Explorer and Edge. There is a bug report to Microsoft about this.
Opera Soporte completo SiSafari ? WebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo SiSafari iOS ? Samsung Internet Android ?
removeChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo SiIE Soporte completo SiOpera Soporte completo SiSafari ? WebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo SiOpera Android Soporte completo SiSafari iOS ? Samsung Internet Android ?
setCustomValidityChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 4IE Soporte completo SiOpera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android ? Safari iOS ? Samsung Internet Android ?

Leyenda

Soporte completo  
Soporte completo
Sin soporte  
Sin soporte
Compatibility unknown  
Compatibility unknown
Ver notas de implementación.
Ver notas de implementación.

See also

  • The <select> HTML element, which implements this interface.

Etiquetas y colaboradores del documento

Colaboradores en esta página: wbamberg
Última actualización por: wbamberg,