Système de design GC Composants
Système de design GC Démarrer Aperçu des modèles de page Page de base Aperçu des composants Avis Barre de navigation latérale Barre de navigation supérieure Bascule de langue Bouton Boutons radio Carte Cases à cocher Champ de date Champ de saisie Chemin de navigation Conteneur Date de modification Détails En-tête Grille Icône Indicateur d'étape Jeu de champs Lien Masquage accessible Menu thématique Message d'erreur Pagination Pied de page Recherche Résumé des erreurs Signature Sélection Texte Titre Téléverseur de fichiers Zone de texte Aperçu des raccourcis CSS Réinitialisation des styles Mise en page réactive État Affichage Dimensionnement de la boîte Dimensionnement du conteneur Débordement Position Visibilité Alignement de texte Couleur de lien Couleur de texte Débordement de texte Décoration de texte de lien Famille de police Hauteur de ligne Police Saut de mot Style de liste Style de police Taille de lien Taille de police Transformation de texte Épaisseur de police Marge Marge intérieure Agencement de contenu Agencement des éléments Agencement individuel Alignement de contenu Alignement des éléments Alignement individuel Colonnes de grille Direction de l’élément flexible Dégagement Habillage de l’élément flexible Justification de contenu Justification des éléments Justification individuelle Lignes de grille Ordre Rétrécissement de l’élément flexible Élargissement de l’élément flexible Élément flexible Couleur de la bordure Couleur de l’arrière-plan Largeur de la bordure Rayon de la bordure Style de la bordure Image Noms des icônes Taille de l'icône Curseur Transition Événements de pointeur Aperçu des styles Unités de style Unités de style de couleur Unités de style d'espacement Unités de style typographie Contactez-nous Impliquez-vous Trouvez une démo

Case à cocher
<gcds-checkbox>

Ce composant est obsolète à partir de la version 0.35.0. Consultez les notes de publication v0.35.0 pour plus d'information.

Autres noms : liste de contrôle, liste de vérification.

La case à cocher permet de proposer un ensemble d'options en vue d'une sélection simple ou multiple.


Créer une case à cocher

Utilisez une case à cocher avec un jeu de champs lorsque vous vous attendez à ce que l’utilisateur·rice choisisse plus d’une option dans une courte liste d’éléments en réponse à une question ou une instruction.

Accessibilité et codage des cases à cocher

Pour que la case à cocher fonctionne correctement, utilisez toujours les attributs suivants avec <gcds-checkbox>:

  • name
  • label
  • checkbox-id

Utilisez un jeu de champs et l’attribut obligatoire

  • Regroupez les options de cases à cocher et nommer le groupe en utilisant la composante de jeu de champs.
  • Utilisez le jeu de champs legend et l’attribut hint pour le nom du groupe et ses instructions.
  • Pour les groupes obligatoires, sélectionnez l’attribut required dans le jeu de champs. La sélection de l’attribut required permet la validation et la gestion des erreurs pour le groupe de cases à cocher.

Pour une seule case à cocher

  • Évitez d’utiliser un jeu de champs pour les cases à cocher avec une seule case à cocher, comme pour une confirmation que les modalités ont été lues avant l’inscription.
  • Utilisez la propriété required pour activer le validateur nécessaire. La validation s’effectuera par défaut pendant l’événement onBlur.
  • Si vous devez modifier l’événement de validation, utilisez l’attribut validate-on. Une validation onBlur est possible lorsque l’élément n’est plus ciblé. Il est également possible de procéder à une validation manuelle avec la méthode validate.
  • Employez l’attribut required lorsqu’une seule case à cocher doit être remplie. Cet attribut insérera la mention « (obligatoire) » à la fin de la case à cocher.
  • Conservez l’attribut error-message par défaut pour une seule case à cocher qui doit être validée. Une entrée manquante affichera un message d’erreur intercalé.
  • Supprimez l’attribut error-message par défaut si la case à cocher est facultative.

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
2025-06-04