Système de design GCComposants
Système de design GC Démarrer Aperçu des modèles de pagePage de base Aperçu des composantsAlerteAvisBarre de navigation latéraleBarre de navigation supérieureBascule de langueBoutonBoutons radioCarteCases à cocherChamp de dateChamp de saisieChemin de navigationConteneurDate de modificationDétailsEn-têteGrilleIcôneIndicateur d'étapeJeu de champsLienMasquage accessibleMenu thématiqueMessage d'erreurPaginationPied de pageRechercheRésumé des erreursSélectionSignatureTableauTéléverseur de fichiersTexteTitreZone de texte Aperçu des raccourcis CSS Réinitialisation des styles Mise en page réactiveÉtat Dimensionnement de la boîteDimensionnement du conteneurAffichageDébordementPositionVisibilité PoliceFamille de policeTaille de policeStyle de policeÉpaisseur de policeHauteur de ligneCouleur de lienTaille de lienDécoration de texte de lienStyle de listeAlignement de texteCouleur de texteDébordement de texteTransformation de texteSaut de mot MargeMarge intérieure Alignement de contenuAlignement des élémentsAlignement individuelÉlément flexibleDirection de l’élément flexibleÉlargissement de l’élément flexibleRétrécissement de l’élément flexibleHabillage de l’élément flexibleDégagementColonnes de grilleLignes de grilleJustification de contenuJustification des élémentsJustification individuelleOrdreAgencement de contenuAgencement des élémentsAgencement individuel Couleur de l'arrière-planCouleur de la bordureRayon de la bordureStyle de la bordureLargeur de la bordure Noms des icônesTaille de l'icôneImage CurseurÉvénements de pointeurTransition Aperçu des stylesUnités de styleCouleurEspacementTypographie Nous contacterS'impliquerTrouvez une démo

Sélection
<gcds-select>

Autres noms : menu déroulant, menu de sélection. Une sélection présente une longue liste d’options parmi lesquelles un seul choix est fait.
  • GitHub
  • Figma

Aperçu du composant de sélection

Sur cette page

Codage et accessibilité de la sélection

Appliquez les attributs essentiels

Utilisez toujours les attributs essentiels suivants avec gcds-select :
  • name
  • label
  • select-id

Définir la valeur par défaut

Utilisez l’attribut default-value pour configurer la première option dans la liste de sélection. Cela empêche la présélection d’une option. Ajouter du texte explicatif
  • Utilisez l'attribut hint pour ajouter du texte explicatif.
  • Évitez d’ajouter, directement dans un champ, du texte explicatif qui disparaît lorsque le champ est sélectionné ou lorsqu'on y saisit une réponse.
Masquer l'étiquette
  • Réglez l'attribut hide-label à true (vrai) pour masquer visuellement l'étiquette tout en la conservant pour les technologies d'assistance.
  • Évitez d'ajouter un texte explicatif lorsque l'étiquette est masquée.
Ajouter la validation et les messages d'erreur
  • Utilisez l'attribut required pour activer la validation et les messages d'erreur intégrés pour la sélection.
  • Les champs comportant des exigences de saisie spécifiques feront l'objet d'une validation, même s'ils ne sont pas obligatoires.
  • Pour les champs facultatifs qui doivent être validés, par exemple pour vérifier le format d'une adresse courriel, ajoutez une validation et des messages d'erreur personnalisés.

Exemples

Explorez les différentes façons de configurer le composant. Chaque exemple présente une mise en œuvre fonctionnelle et du code prêt à copier.

Dans cette section

Attributs essentiels

Ces attributs sont requis pour que le composant fonctionne correctement.

label

L’attribut label définit le libellé du composant de sélection. 
<gcds-select select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

name

L’attribut name identifie le composant dans le formulaire. Il permet de récupérer la valeur sélectionnée après la soumission. 
<gcds-select select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

select-id

L’attribut select-id définit l’identifiant unique du composant de sélection. 
<gcds-select select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

Attributs facultatifs

Ces attributs vous permettent de personnaliser ou d’enrichir le comportement et la présentation du composant.

autocomplete

L’attribut autocomplete contrôle si le navigateur peut suggérer des valeurs précédemment saisies pour le composant de sélection. 
<gcds-select autocomplete="on" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

autofocus

L’attribut autofocus contrôle si le composant de sélection est ciblé automatiquement au chargement de la page. Par défaut, il est défini à false. Lorsqu’il est défini à true, le composant de sélection est ciblé à l’affichage. 
<gcds-select autofocus="true" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

default-value

L’attribut default-value définit une valeur facultative affichée avant que l’utilisateur sélectionne une option. 
<gcds-select select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

disabled

L’attribut disabled contrôle si le composant de sélection est désactivé ou non. Par défaut, il est défini à false. 
<gcds-select disabled="true" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

error-message

L’attribut error-message définit le message d’erreur à afficher pour une sélection invalide. 
<gcds-select error-message="Message d'erreur" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

form

L’attribut form définit l’identifiant du formulaire auquel appartient le composant de sélection. 
<gcds-select form="form-id" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

hide-label

L’attribut hide-label contrôle si le libellé est masqué ou non. 
<gcds-select hide-label="true" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

hint

L’attribut hint définit le texte explicatif affiché sous le libellé. 
<gcds-select hint="Texte explicatif / Exemple de message." select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

required

L’attribut required contrôle si la sélection est obligatoire ou non. Lorsqu’il est défini à true, il ajoute « obligatoire » après le libellé, et active le validateur de champ obligatoire. 
<gcds-select required="true" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

validate-on

L’attribut validate-on définit l’événement de validation pour le composant de sélection. 
<gcds-select validate-on="other" required="true" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

value

L’attribut value contient la valeur de l’option actuellement sélectionnée. Il se met à jour à chaque changement de sélection. 
<gcds-select value="2" select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>

Emplacements (slots)

L’emplacement par défaut vous permet d’injecter du contenu personnalisé dans la zone de contenu principale du composant, et les emplacements nommés, dans des zones spécifiques.

default

L’emplacement par défaut sert à ajouter des options et des groupes d’options. 
<gcds-select select-id="select-preview" label="Libellé" name="select-preview" default-value="Sélectionner une option">
  <option value="1">Option 1</option>
  <option value="2">Option 2</option>
  <option value="3">Option 3</option>
</gcds-select>
Générateur de code Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.
  • Choisissez des valeurs de code pour obtenir l'élément que vous voulez.
  • Obtenez le code et intégrez-le dans votre environnement.
  • Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).
Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.
Aidez-nous à nous améliorer Vous avez des questions ou des demandes? Faites-nous part de vos commentaires à l'aide de notre formulaire de contact. Quelque chose ne va pas? Signalez-le sur GitHub en créant un compte. Vous pourrez accéder aux réponses de l'équipe, suivre les progrès réalisés concernant votre problèmes et voir les problèmes signalés par d'autres personnes. Fournir des commentaires Signaler un problème sur GitHub
2026-02-12