Bouton
<gcds-button>

Autres noms : appel à l’action.

Un bouton est un objet interactif qui met l’accent sur une action.

• GitHub
• Figma

Sur cette page

• Codage et accessibilité des boutons
• Exemples
• Générateur de code

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.

Dans cette section

• Attributs facultatifs
• Emplacements (slots)

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>
  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>
  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>

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.

1. Choisissez des valeurs de code pour obtenir l'élément que vous voulez.

2. Obtenez le code et intégrez-le dans votre environnement.

3. 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.