HTMLSelectElement

Propriétés d'instance

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

Une chaîne de caractères reflétant l'attribut HTML autocomplete, qui indique si la valeur du contrôle peut être automatiquement complétée par le navigateur.

Un booléen reflétant l'attribut HTML disabled qui indique si le contrôle est désactivé. S'il est désactivé, il n'accepte pas les clics.

Un objet HTMLFormElement référençant le formulaire auquel cet élément est associé. Si l'élément n'est pas associé à un élément HTML <form>, il retourne null.

Un noeud (NodeList) d'éléments HTML <label> associés à l'élément.

Un unsigned long. Le nombre d'éléments HTML <option> dans cet élément select.

Un booléen reflétant l'attribut HTML multiple qui indique si plusieurs éléments peuvent être sélectionnés.

Une chaîne de caratères reflétant l'attribut HTML name contenant le nom de ce contrôle utilisé par les serveurs et les fonctions de recherche DOM.

Un objet HTMLOptionsCollection représentant l'ensemble des <option> (HTMLOptionElement) contenus par cet élément.

Un booléen reflétant l'attribut HTML required qui indique si l'utilisateur·ice doit sélectionner une valeur avant de soumettre le formulaire.

Un long reflétant l'indice du premier élément HTML <option> sélectionné. La valeur -1 indique qu'aucun élément n'est sélectionné.

Une collection d'éléments (HTMLCollection) représentant l'ensemble des éléments HTML <option> qui sont sélectionnés.

Un long reflétant l'attribut HTML size attribut HTML, qui contient le nombre d'éléments visibles dans le contrôle. La valeur par défaut est 1, sauf si multiple est true, auquel cas elle est de 4.

Une chaîne de caractères représentant le type du contrôle de formulaire. Lorsque multiple est true, il retourne "select-multiple" ; sinon, il retourne "select-one".

Une chaîne de caractères représentant un message localisé qui décrit les contraintes de validation que le contrôle ne satisfait pas (le cas échéant). Cet attribut est la chaîne vide si le contrôle n'est pas un candidat à la validation des contraintes (willValidate est faux), ou s'il satisfait à ses contraintes.

Un objet ValidityState reflétant l'état de validité dans lequel se trouve ce contrôle.

Une chaîne de caractères reflétant la valeur du contrôle de formulaire. Renvoie la propriété value du premier élément d'option sélectionné s'il y en a un, sinon la chaîne vide.

Un booléen qui indique si le bouton est un candidat à la validation des contraintes. Il vaut false si des conditions l'empêchent de bénéficier de la validation par contrainte.

Méthodes d'instance

Cette interface hérite des méthodes de HTMLElement, et de Element et Node.

Ajoute un élément à la collection d'éléments option pour cet élément select.

Vérifie si l'élément a des contraintes et s'il les satisfait. Si l'élément ne respecte pas ses contraintes, le navigateur déclenche un évènement invalid annulable sur l'élément (et retourne false).

Obtient un élément de la collection d'options de l'élément <select>. Vous pouvez également accéder à un élément en spécifiant l'index entre des parenthèses ou des crochets de style tableau, sans appeler cette méthode explicitement.

Obtient l'élément dans la collection d'options avec le nom spécifié. La chaîne de nom peut correspondre soit au id, soit à l'attribut name d'un nœud d'option. Vous pouvez également accéder à un élément en spécifiant le nom entre des crochets de style tableau ou des parenthèses, sans appeler cette méthode explicitement.

Supprime l'élément à l'indice spécifié de la collection d'options pour cet élément select.

Cette méthode signale à l'utilisateur·ice les problèmes liés aux contraintes sur l'élément, le cas échéant. S'il y a des problèmes, elle déclenche un évènement invalid annulable sur l'élément, et retourne false ; s'il n'y a pas de problèmes, elle retourne true.

Définit le message de validation personnalisé pour l'élément de sélection au message spécifié. Utilisez la chaîne vide pour indiquer que l'élément n'a pas d'erreur de validité personnalisée.

Affiche le sélecteur d'options.

Évènements

Cette interface hérite des évènements de HTMLElement, ainsi que de Element et Node.

Écoutez ces évènements en utilisant addEventListener() ou en affectant un écouteur d'évènement à la propriété oneventname de cette interface :

Se déclenche lorsque l'utilisateur·ice sélectionne une option.

S'active lorsque la valeur d'un élément <input>, <select> ou <textarea> a été modifiée.

Exemples

Obtenir des informations sur l'option sélectionnée

Une meilleure façon de suivre les modifications apportées à la sélection de l'utilisateur consiste à surveiller l'évènement 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'évènement change pour plus de détails.

Spécifications

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

• L'élément HTML <select>, qui implémente cette interface.