HTMLSelectElement

Proprits d'instance

Cette interface hrite des proprits de HTMLElement, de Element et de Node.

HTMLSelectElement.autocomplete

Une chane de caractres refltant l'attribut HTML autocomplete, qui indique si la valeur du contrle peut tre automatiquement complte par le navigateur.

HTMLSelectElement.disabled

Un boolen refltant l'attribut HTML disabled qui indique si le contrle est dsactiv. S'il est dsactiv, il n'accepte pas les clics.

HTMLSelectElement.form Lecture seule

Un objet HTMLFormElement rfrenant le formulaire auquel cet lment est associ. Si l'lment n'est pas associ un lment HTML <form>, il retourne null.

HTMLSelectElement.labels Lecture seule

Un noeud (NodeList) d'lments HTML <label> associs l'lment.

HTMLSelectElement.length

Un unsigned long. Le nombre d'lments HTML <option> dans cet lment select.

HTMLSelectElement.multiple

Un boolen refltant l'attribut HTML multiple qui indique si plusieurs lments peuvent tre slectionns.

HTMLSelectElement.name

Une chane de caratres refltant l'attribut HTML name contenant le nom de ce contrle utilis par les serveurs et les fonctions de recherche DOM.

HTMLSelectElement.options Lecture seule

Un objet HTMLOptionsCollection reprsentant l'ensemble des <option> (HTMLOptionElement) contenus par cet lment.

HTMLSelectElement.required

Un boolen refltant l'attribut HTML required qui indique si l'utilisateurice doit slectionner une valeur avant de soumettre le formulaire.

HTMLSelectElement.selectedIndex

Un long refltant l'indice du premier lment HTML <option> slectionn. La valeur -1 indique qu'aucun lment n'est slectionn.

HTMLSelectElement.selectedOptions Lecture seule

Une collection d'lments (HTMLCollection) reprsentant l'ensemble des lments HTML <option> qui sont slectionns.

HTMLSelectElement.size

Un long refltant l'attribut HTML size attribut HTML, qui contient le nombre d'lments visibles dans le contrle. La valeur par dfaut est 1, sauf si multiple est true, auquel cas elle est de 4.

HTMLSelectElement.type Lecture seule

Une chane de caractres reprsentant le type du contrle de formulaire. Lorsque multiple est true, il retourne "select-multiple" ; sinon, il retourne "select-one".

HTMLSelectElement.validationMessage Lecture seule

Une chane de caractres reprsentant un message localis qui dcrit les contraintes de validation que le contrle ne satisfait pas (le cas chant). Cet attribut est la chane vide si le contrle n'est pas un candidat la validation des contraintes (willValidate est faux), ou s'il satisfait ses contraintes.

HTMLSelectElement.validity Lecture seule

Un objet ValidityState refltant l'tat de validit dans lequel se trouve ce contrle.

HTMLSelectElement.value

Une chane de caractres refltant la valeur du contrle de formulaire. Renvoie la proprit value du premier lment d'option slectionn s'il y en a un, sinon la chane vide.

HTMLSelectElement.willValidate Lecture seule

Un boolen qui indique si le bouton est un candidat la validation des contraintes. Il vaut false si des conditions l'empchent de bnficier de la validation par contrainte.

Mthodes d'instance

Cette interface hrite des mthodes de HTMLElement, et de Element et Node.

HTMLSelectElement.add()

Ajoute un lment la collection d'lments option pour cet lment select.

HTMLSelectElement.checkValidity()

Vrifie si l'lment a des contraintes et s'il les satisfait. Si l'lment ne respecte pas ses contraintes, le navigateur dclenche un vnement invalid annulable sur l'lment (et retourne false).

HTMLSelectElement.item()

Obtient un lment de la collection d'options de l'lment <select>. Vous pouvez galement accder un lment en spcifiant l'index entre des parenthses ou des crochets de style tableau, sans appeler cette mthode explicitement.

HTMLSelectElement.namedItem()

Obtient l'lment dans la collection d'options avec le nom spcifi. La chane de nom peut correspondre soit au id, soit l'attribut name d'un nud d'option. Vous pouvez galement accder un lment en spcifiant le nom entre des crochets de style tableau ou des parenthses, sans appeler cette mthode explicitement.

HTMLSelectElement.remove()

Supprime l'lment l'indice spcifi de la collection d'options pour cet lment select.

HTMLSelectElement.reportValidity()

Cette mthode signale l'utilisateurice les problmes lis aux contraintes sur l'lment, le cas chant. S'il y a des problmes, elle dclenche un vnement invalid annulable sur l'lment, et retourne false ; s'il n'y a pas de problmes, elle retourne true.

HTMLSelectElement.setCustomValidity()

Dfinit le message de validation personnalis pour l'lment de slection au message spcifi. Utilisez la chane vide pour indiquer que l'lment n'a pas d'erreur de validit personnalise.

HTMLSelectElement.showPicker()

Affiche le slecteur d'options.

vnements

Cette interface hrite des vnements de HTMLElement, ainsi que de Element et Node.

coutez ces vnements en utilisant addEventListener() ou en affectant un couteur d'vnement la proprit oneventname de cette interface :

vnement change

Se dclenche lorsque l'utilisateurice slectionne une option.

vnement input

S'active lorsque la valeur d'un lment <input>, <select> ou <textarea> a t modifie.

Exemples

Obtenir des informations sur l'option slectionne

/* en supposant que nous ayons le HTML suivant
<select id='s'>
    <option>Premier</option>
    <option selected>Deuxime</option>
    <option>Troisime</option>
</select>
*/

const select = document.getElementById("s");

// renvoie l'index de l'option slectionne
console.log(select.selectedIndex); // 1

// retourne la valeur de l'option slectionne
console.log(select.options[select.selectedIndex].value); // Deuxime

Une meilleure faon de suivre les modifications apportes la slection de l'utilisateur consiste surveiller l'vnement change qui se produit sur le <select>. Cela vous indiquera quand la valeur change, et vous pourrez alors mettre jour ce dont vous avez besoin. Voir l'exemple fourni dans la documentation de l'vnement change pour plus de dtails.

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'lment HTML <select>, qui implmente cette interface.