Lien
<gcds-link>

Autres noms : ancre, lien hypertexte, appel à l'action.

Un lien est un élément de navigation qui amène une personne à une nouvelle page, à un autre site Web, à un fichier ou à une nouvelle section de la page actuelle.

• GitHub
• Figma

Sur cette page

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

Codage et accessibilité des liens

Fournissez des informations pour télécharger des fichiers

• Fournissez dans le texte du lien des renseignements sur le type et la taille des fichiers à télécharger : <gcds-link href="application.pdf" download>Demande 2023 (PDF, 1,5 Mo)</gcds-link>.
• Évitez de placer le lien de téléchargement dans le texte du paragraphe.

Remarque : Seuls les fichiers dont l'URL est de la même origine que le site Web seront téléchargés sur l'appareil de l'utilisateur·rice.

Ajoutez un lien « Passer au contenu »

• Un lien « Passer au contenu » permet à une personne de sauter un ensemble de liens de navigation pour passer au contenu principal.
• Pour éviter de dissimuler le contenu, configurez le lien de manière à ce qu'il pousse le contenu vers le bas et ne flotte pas. Pour la version bureau, placez le lien « Passer au contenu » en haut à gauche de la page afin qu'il n'interrompe pas le flux.

Évitez les liens externes dans la mesure du possible

• Ajoutez un lien externe en définissant l'attribut external à true.
• Évitez d'ajouter des liens externes dans les cas suivants :
  • Au milieu de la progression d'une personne, par exemple lorsqu'une personne remplit un formulaire.
  • Si changer de page cause une perte de progression non enregistrée.
  • Si le fait de suivre un lien met fin à un processus entamé, par exemple lorsqu'une personne regarde une vidéo ou effectue une tâche principale.
  • Lorsqu'un lien est envahissant et perturberait le flux de la page.
  • Lorsqu'une personne serait surprise de se retrouver ailleurs de manière inattendue.
• Indiquez clairement où mène le lien, afin qu'une personne puisse décider si elle doit quitter la page actuelle.
• Communiquez clairement lorsque les liens sont assortis de conditions particulières. Par exemple, lorsqu'ils sont uniquement accessibles à l'intérieur d'un réseau fermé en raison d'un pare-feu.

Dans cette section

• Attributs essentiels
• Attributs facultatifs
• Emplacements (slots)

href

L'attribut href définit l'URL de la page vers laquelle pointe le lien.

<gcds-link href="#">Lien de navigation</gcds-link>

display

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

• inline (par défaut)
• block

<gcds-link display="block" href="#">Lien de navigation</gcds-link>

download

L'attribut download indique que la cible (le fichier spécifié dans l'attribut href) sera téléchargée lorsque l'utilisateur clique sur le lien.

<gcds-link href="download.pdf" download="file.pdf" type="application/pdf">
  Télécharger le document (PDF, 1,5 Mb)
</gcds-link>

external

L'attribut external contrôle si le lien est externe ou non. Lorsqu'il est défini à true, une icône de lien externe est ajoutée après le lien.

<gcds-link external href="#">Lien de navigation</gcds-link>

link-role

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

• default (par défaut)
• light

<div class="bg-dark p-300">
  <gcds-link link-role="light" href="#">Lien de navigation</gcds-link>
</div>

rel

L'attribut rel définit la relation entre le document actuel et le document lié. Il est souvent utilisé pour des raisons de sécurité et de confidentialité, notamment lorsque les liens s'ouvrent dans un nouvel onglet ou une nouvelle fenêtre.

<gcds-link rel="license" href="#license">Lien de navigation</gcds-link>

size

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

• inherit (par défaut)
• regular
• small

<gcds-link size="small" href="#">Lien de navigation</gcds-link>

target

L'attribut target définit où s'ouvre le lien. Par exemple, il peut ouvrir le lien dans le même contexte de navigation ou dans un nouvel onglet ou une nouvelle fenêtre.

<gcds-link target="_blank" href="#">Lien de navigation</gcds-link>

type

L'attribut type définit le type de média du document lié.

<gcds-link href="download.pdf" download="file.pdf" type="application/pdf">
  Télécharger le document (PDF, 1,5 Mb)
</gcds-link>

default

L'emplacement par défaut sert à placer le texte du lien.

<gcds-link href="#">Lien de navigation</gcds-link>

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.