HTMLSelectElement

L'interface HTMLSelectElement représente un élément HTML <select>. Cet élément partage aussi toute les propriétés et méthodes des autres elements HTML via l'interface HTMLElement.

Propriétés

Cette interface hérite des propriétés de HTMLElement, Element et Node.

HTMLSelectElement.autofocus

Est un Boolean qui reflète l'attribut HTML autofocus : il indique si l'élément a le focus au chargement de la page (excepté si l'utilisateur le change, par exemple en cliquant sur un autre element). Uniquement les elément associé à un formulaire dans le document peuvent utiliser cet attribut.

HTMLSelectElement.disabled

Est un Boolean qui reflète l'attribut HTML disabled : il indique si l'élément est oui ou non desactivé. Si il est désactivé, l'élément n'accepte pas les clicks.

HTMLSelectElement.form Lecture seule

Retourne un HTMLFormElement représentant le formulaire associé a cet élément. Si cet élément est le fils d'un formulaire, alors cet attribut est l'ID de l'element form. Si l'élément n'est pas fils d'un formulaire, alors l'attribut peut-être l'ID de n'importe quel élément du même document.

HTMLSelectElement.labels Lecture seule

Retourne une NodeList contenant la liste des labels associé avec l'éléments select.

HTMLSelectElement.length

Est un unsigned long représentant le nombre d'élément <option> dans cet element select.

HTMLSelectElement.multiple

Est un Boolean représentant l'attribut HTML multiple, qui indique si plusieurs items peuvent être choisis à la fois par l'utilisateur.

HTMLSelectElement.name

Est une DOMString qui représente l'attribut HTML name, contenant le nom de ce contrôle pour les serveurs et pour les fonctions de recherche dans le DOM.

HTMLSelectElement.options Lecture seule

Returns a HTMLOptionsCollection containing the set of <option> elements contained by this element.

HTMLSelectElement.required

Is a Boolean that reflects the required HTML attribute, which indicates whether the user is required to select a value before submitting the form.

HTMLSelectElement.selectedIndex

Is a long that reflects the index of the first selected <option> element. The value -1 indicates no element is selected.

HTMLSelectElement.selectedOptions Lecture seule

Returns a live HTMLCollection containing the set of options that are selected.

HTMLSelectElement.size

Is a long that reflects 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.type Lecture seule

Returns a DOMString the form control's type. When multiple is true, it returns "select-multiple"; otherwise, it returns "select-one".

HTMLSelectElement.validationMessage Lecture seule

Returns a DOMString containing 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.validity Lecture seule

Returns a ValidityState representing the validity state that this control is in.

HTMLSelectElement.value

Is a DOMString with the value of this form control, that is, of the first selected option.

HTMLSelectElement.willValidateLecture seule

Is a Boolean that indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation.

Méthodes

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.

Exemple

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
alert(select.selectedIndex); // 1

// return the value of the selected option
alert(select.options[select.selectedIndex].value) // Second

Specifications

Browser compatibility

See also

• The <select> HTML element, implementing this interface.