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

Bouton
<gcds-button>

Autres noms : appel à l’action. Un bouton est un objet interactif qui met l’accent sur une action.
  • GitHub
  • Figma

Aperçu du composant de bouton

Sur cette page

Codage et accessibilité des boutons

Évaluez l’accessibilité visuelle

Vérifiez la visibilité de la bordure du bouton par rapport à la surface où vous le placez.

Sélectionnez la bonne taille

Utilisez l’attribut petit bouton pour les actions lorsque l’espace est limité. Remarque : La hauteur des petits boutons est conforme au niveau AA de la norme WCAG, mais pas au niveau AAA.

Utilisez le bouton désactivé avec parcimonie

  • Utilisez le bouton désactivé de façon limitée pour indiquer qu’une personne doit effectuer une action avant d’en lancer une autre.
  • Lorsque possible, privilégiez d’autres moyens, comme un message d’erreur, pour empêcher l’envoi d’un formulaire incomplet.

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 facultatifs

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

button-id

Utilisez button-id pour préciser le id du bouton. 
<gcds-button id="submit-ei-application">
  Soumettre
</gcds-button>

button-role

Utilisez button-role pour définir le style principal d’un bouton. Choisissez parmi :
  • primary (par défaut)
  • secondary
  • danger
  • start
<gcds-button button-role="start">Début</gcds-button>
<gcds-button>Soumettre</gcds-button>
<gcds-button button-role="secondary">Annuler</gcds-button>
<gcds-button button-role="danger">Supprimer</gcds-button>

disabled

Définissez disabled à true pour rendre le bouton non interactif. Par défaut, disabled est défini à false. 
<gcds-button button-role="danger" disabled="true">
  Supprimer
</gcds-button>

name

Utilisez name pour préciser le nom du bouton lors de l’envoi des données du formulaire. Cet attribut permet d’identifier quel bouton a déclenché l’envoi, notamment lorsque plusieurs boutons sont présents dans un formulaire. 
<form action="..." method="post">
  <gcds-button button-role="secondary" name="save-draft" type="submit">
    Enregistrer le brouillon
  </gcds-button>
  <gcds-button button-role="secondary" name="submit-application" type="submit">
    Soumettre le formulaire
  </gcds-button>
</form>

size

Utilisez size pour définir la taille du bouton. Choisissez parmi :
  • regular (par défaut)
  • small
<gcds-button>Taille par défaut</gcds-button>
<gcds-button size="small">Taille petite</gcds-button>

type

Utilisez type pour définir la fonction du bouton. Choisissez parmi :
  • button (par défaut)
  • link
  • reset
  • submit
<gcds-button>Bouton</gcds-button>
<gcds-button type="link">Lien</gcds-button>
<gcds-button type="reset">Réinitialiser</gcds-button>
<gcds-button type="submit">Soumettre</gcds-button>

value

Utilisez value pour définir les données envoyées au serveur lorsque le bouton sert à soumettre un formulaire. Le bouton ne transmet cette valeur que s’il a un attribut name et que c’est lui qui a déclenché la soumission. Si plusieurs boutons submit sont présents, seul le bouton sélectionné envoie sa valeur. 
<form action="..." method="post">
  <gcds-button button-role="secondary" type="submit" name="applicationAction" value="save">
    Enregistrer le brouillon
  </gcds-button>
  <gcds-button button-role="secondary" type="submit" name="applicationAction" value="submit">
    Soumettre le formulaire
  </gcds-button>
</form>

download

Utilisez download pour faire en sorte que le bouton télécharge le fichier référencé par l’attribut href, plutôt que d’y naviguer. Cet attribut fonctionne uniquement lorsque le type du bouton est défini à link. 
<gcds-button type="link" href="/files/application-receipt.pdf" download="true">
  Télécharger le reçu
</gcds-button>

href

Utilisez href pour définir la destination du lien. Cet attribut fonctionne uniquement lorsque le type du bouton est défini à link. 
<gcds-button type="link" href="https://www.canada.ca/en/services/benefits.html">
  Voir les prestations
</gcds-button>

rel

Utilisez rel pour définir la relation entre le document actuel et le document lié. Utilisez-le pour des raisons de sécurité et de confidentialité, notamment lorsque les liens s’ouvrent dans un nouvel onglet ou une nouvelle fenêtre. Cet attribut fonctionne uniquement lorsque le type du bouton est défini à link. 
<gcds-button type="link" href="https://www.canada.ca/en/services/benefits.html" target="_blank" rel="noopener noreferrer">
  Voir les prestations
</gcds-button>

target

Utilisez target pour définir où s’ouvre le lien : dans le même contexte de navigation, ou dans un nouvel onglet ou une nouvelle fenêtre. Cet attribut fonctionne uniquement lorsque le type du bouton est défini à link. 
<gcds-button type="link" href="https://www.canada.ca/en/services/benefits.html" target="_blank" rel="noopener noreferrer">
  Voir les prestations
</gcds-button>

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

Utilisez l’emplacement par défaut pour ajouter le texte du bouton ou du lien. 
<gcds-button>Soumettre</gcds-button>
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. Début
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-07-08