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

Aperçu du composant de lien

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.

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.

Attributs essentiels

Ces attributs sont requis pour que le composant fonctionne correctement.

`href`

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

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

Attributs facultatifs

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

`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="true" 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>

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`

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.

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.

Lien de navigation

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

Lien<gcds-link>