<select>

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'élément HTML<select> représente un contrôle qui fournit une liste d'options parmi lesquelles l'utilisateur pourra choisir.

Exemple interactif

<label for="pet-select">Choose a pet:</label><select name="pets">  <option value="">--Please choose an option--</option>  <option value="dog">Dog</option>  <option value="cat">Cat</option>  <option value="hamster">Hamster</option>  <option value="parrot">Parrot</option>  <option value="spider">Spider</option>  <option value="goldfish">Goldfish</option></select>

label {  font-family: sans-serif;  font-size: 1rem;  padding-right: 10px;}select {  font-size: 0.9rem;  padding: 2px 5px;}

L'exemple ci-avant illustre une utilisation simple de<select> où l'attributid peut être associé à un élément<label> qui permettra d'avoir un libellé accessible pour ce champ et où un attributname représente le nom de la donnée qui sera envoyée au serveur. Chaque option est définie grâce à un élément<option> qui se situe à l'intérieur de l'élément<select>.

Chaque élément<option> doit avoir un attributvalue qui contient la valeur qui sera envoyée au serveur lorsque l'option est sélectionnée. Si aucune valeur n'est fournie, la valeur par défaut sera le texte contenu dans l'élément. Il est possible d'inclure un attributselected sur un élément<option> afin que cette option soit sélectionnée par défaut au chargement de la page.

L'élément<select> possède certains attributs spécifiques dontmultiple qui permet de choisir plusieurs options simultanément etsize qui indique le nombre d'options affichées en même temps. Cet élément accepte également divers attributs qui sont utilisés pour les champs de formulaire tels querequired,disabled,autofocus, etc.

Il est possible de regrouper plusieurs éléments<option> à l'intérieur d'éléments<optgroup> afin de créer des groupes d'options distincts.

Pour plus d'exemples, voirles contrôles natifs pour les formulaires.

Attributs

Comme tous les autres éléments HTML, celui-ci inclutles attributs universels.

autocomplete: Une chaîne de caractères qui fournit une indication à l'agent utilisateur pour les fonctionnalités d'autocomplétion. Voirla page sur l'attributautocomplete pour une liste des valeurs utilisables et de leurs impacts sur l'autocomplétion.
autofocus: Cet attribut booléen permet d'indiquer si ce contrôle du formulaire devrait recevoir le focus au chargement de la page. Pour un même document, seul un élément de formulaire peut avoir l'attributautofocus activé.
disabled: Cet attribut booléen indique que l'utilisateur ne peut pas intéragir avec le contrôle. Si cet attribut n'est pas utilisé, le contrôle héritera de l'état paramétré selon son conteneur (par exemple, via son élément parent<fieldset>. Si aucun élément parent n'a l'attributdisabled activé, le contrôle sera actif.
form: Cet attribut sert de référence au formulaire auquel est associé cet élément. Si cet attribut est utilisé, sa valeur doit être l'identifiant d'un élément<form> du même document. Cet attribut permet de placer des éléments n'importe où dans le document et pas nécessairement comme descendants d'un formulaire.
multiple: Cet attribut booléen indique qu'on peut sélectionner plusieurs options parmi celles offertes dans le contrôle. Par défaut, si cet attribut n'est pas utilisé, seule une option peut être sélectionnée.
name: Le nom associé au contrôle.
required: Un attribut booléen qui indique qu'une option dont la valeur est une chaîne de caractères non-vide doit être sélectionnée.
size: Si le contrôle est affichée comme une liste déroulante, cet attribut indique le nombre de lignes qui doivent être visibles à l'écran en même temps. On notera que les navigateurs ne sont pas obligés de présenter un élément<select> sous la forme d'une liste déroulante. La valeur par défaut de cet attribut est 0 (cf. notes de compatibilité ci-après).

Mise en forme avec CSS

Il est communément admis que l'élément<select> est difficilement mis en forme avec CSS. Certains aspects de l'élément,son modèle de boîte,la police utilisée ou encore l'apparence (appearance), peuvent être modifiés.

Toutefois, ces propriétés peuvent fournir des résultats incohérents entre les différents navigateurs et il peut être difficile d'aligner différents contrôles sur une colonne.Aussi, si la structure interne de cet élément est trop complexe, on pourra créer un tel contrôle en utilisant des éléments non sémantiques, du code JavaScript et WAI-ARIA afin de décrire la sémantique du contrôle.

Pour plus d'informations sur la mise en forme de<select> :

Exemples

Exemple basique

HTML

html

<!-- C'est la deuxième valeur --><!-- qui sera initialement sélectionnée --><select>  <option value="valeur1">Valeur 1</option>  <option value="valeur2" selected>Valeur 2</option>  <option value="valeur3">Valeur 3</option></select>

Résultat

Exemple multi-selection

L'exemple qui suit est légèrement plus complexe et illustre certaines fonctionnalités qui peuvent être utilisées avec un élément<select> :

html

<label  >Veuillez choisir un ou plusieurs animaux :  <select name="pets" multiple size="4">    <optgroup label="Animaux à 4-jambes">      <option value="Chien">Chien</option>      <option value="chat">Chat</option>      <option value="hamster" disabled>Hamster</option>    </optgroup>    <optgroup label="Animaux volants">      <option value="perroquet">Perroquet</option>      <option value="macaw">Macaw</option>      <option value="albatros">Albatros</option>    </optgroup>  </select></label>

Résultat

Cet exemple n'est pas disponible de façon interactive (le moteur de MDN supprime l'attributmultiple lors de l'affichage de la page) mais vous pouvez voirl'exemple sur GitHub.

Vous pourrez voir que :

Plusieurs options peuvent être sélectionnées grâce à l'attributmultiple.
L'attributsize permet d'afficher uniquement 4 lignes simultanément et qu'il faut faire défiler le contenu.
Les éléments<optgroup> ont été utilisés pour diviser les choix en différents groupes. Cela applique un effet simplement visuel (avec le nom en gras et les options indentées).
Le choix "Hamster" est présent avec l'attributdisabled et ne peut donc pas être sélectionné.

Note :Sur un ordinateur de bureau, on pourra maintenir les touchesCtrl,Command, ouShift en cliquant afin de sélectionner/déselectionner plusieurs options.

Sélectionner plusieurs options

Sur un ordinateur de bureau, il existe différentes façons de sélectionner plusieurs options pour un élément<select> utilisant un attributmultiple.

Pour les personnes qui utilisent la souris, il est possible de maintenir les touchesCtrl,Command ouShift (selon le système d'exploitation utilisé) et de cliquer sur les différentes options afin de les sélectionner/déselectionner.

Attention :Les moyens décrits ci-après pour sélectionner des options qui ne sont pas contigües semblent ne fonctionner qu'avec Firefox. On notera également que sur macOS, les raccourcisCtrl +Bas etCtrl +Haut sont utilisées par défaut par le système d'exploitation et qu'il faut les désactiver si on souhaite qu'ils fonctionnent dans le navigateurs.

Les utilisateurs du clavier pourront sélectionner des options contigües de la façon suivante :

Placer le focus sur l'élément<select> (avec la touche
Tab
par exemple).
Sélectionner une option en haut ou en bas de l'intervalle en se déplaçant avec les touches
Haut
et
Bas
.
Maintenir la touche
Shift
puis utiliser les touches
Haut
et
Bas
pour augmenter ou réduire le nombre d'options sélectionnées.

Les utilisateurs du clavier pourront sélectionner des options non-contigües de la façon suivante :

Placer le focus sur l'élément<select> (avec la touche
Tab
par exemple).
Maintenir la touche
Ctrl
puis utiliser les touches
Haut
et
Bas
pour modifier le focus sur l'option qu'on souhaite choisir ou rejeter. L'option avec le focus sera entourée par un contour en pointillé.
Appuyer sur
Espace
pour sélectionner/déselectionner les options avec le focus et ainsi de suite pour les différentes options.

Résumé technique

Catégories de contenu	Contenu de flux,contenu phrasé,contenu interactif,contenu de formulaire (listé, étiquetable, réinitialisable, qui peut être envoyé).
Contenu autorisé	Zéro ou plusieurs éléments`<option>` ou`<optgroup>`.
Omission de balises	Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisés	Tout élément qui accepte ducontenu phrasé.
Rôles ARIA autorisé	`menu`
Interface DOM	`HTMLSelectElement`