Texte
<gcds-text>

Autres noms : bloc de texte, version, légende, corps du texte, paragraphe.

Le composant texte est un paragraphe stylisé et formaté qui affiche du contenu écrit de manière accessible.

• GitHub
• Figma

Sur cette page

• Codage et accessibilité du composant texte
• Exemples
• Générateur de code

Codage et accessibilité du composant texte

Veillez à maintenir des limites de caractères accessibles

• Maintenez la longueur de ligne maximale par défaut de 65 caractères pour chaque ligne de texte pour assurer une lecture aisée et accessible.
• Choisissez de raccourcir la longueur de ligne en définissant l'attribut character-limit à false.

Définissez la taille du texte

• Définissez l'attribut de texte size à body ou small.
• Utilisez la valeur par défaut body size pour produire un élément p avec la taille de police et le contraste de couleur recommandés.
• Choisissez d'afficher un texte plus petit en définissant l'attribut size à small pour produire un élément small à l'intérieur d'un élément p.

Utilisez des styles de texte avec prudence

• Ne soulignez que les liens.
• Utilisez le texte en caractères gras avec prudence.
• Évitez d'utiliser du texte en gras comme titre. Le titre est le composant accessible permettant d'identifier les sections de contenu.
• Pour le texte en caractères gras, utilisez la balise strong dans le composant gcds-text pour mettre en évidence les termes et souligner les points clés.
• Utilisez uniquement les caractères en italiques dans les cas suivants :
  • Références juridiques, comme la Loi canadienne sur l'accessibilité.
  • Mots dans d'autres langues, y compris le latin.
  • Titres de publications, d'œuvres d'art et de matériel mathématique et scientifique.
• Utilisez la balise em dans le composant gcds-text pour mettre l'accent sur des mots ou des phrases spécifiques.

Dans cette section

• Attributs facultatifs
• Emplacements (slots)

character-limit

L'attribut character-limit définit la longueur de ligne maximale en nombre de caractères pour garantir une longueur de lecture confortable et accessible.

<gcds-text character-limit="false">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

display

L'attribut display définit le comportement d'affichage du texte. Les options sont :

• block (par défaut)
• flex
• inline
• inline-block
• inline-flex
• none

<gcds-text display="flex">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

margin-bottom

L'attribut margin-bottom définit la marge sous le texte. La valeur par défaut est 300.

<gcds-text margin-bottom="600">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

margin-top

L'attribut margin-top définit la marge au-dessus du texte. La valeur par défaut est 0.

<gcds-text margin-top="600">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

size

L'attribut size définit la taille du texte. Les options sont :

• body (par défaut)
• small

<gcds-text size="small">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

text-role

L'attribut text-role définit le style principal du texte. Les options sont :

• primary (par défaut)
• secondary
• light

<gcds-text text-role="secondary">
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

default

L'emplacement par défaut sert à placer le contenu de l'élément texte.

<gcds-text>
  Il s'agit d'un texte lié au titre qui décrit plus en détail le sujet ou l'action du titre. Le texte est généralement une ou plusieurs lignes ou paragraphes qui forment le contenu d'une section ou introduisent une liste à puces, un tableau ou tout autre contenu, comme une image ou une vidéo.
</gcds-text>

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.