<link>

Relie le document à une ressource externe : une feuille de style, l’icône de la page, une police ou une autre version linguistique.

Affichage
none
Balise fermante
Aucune, élément vide
Contenu autorisé
Aucun, élément vide
Sur cette page

Exemple

#
HTML
<head>
  <meta charset="utf-8">
  <title>Cours de HTML et CSS pour débutants | CodeWorlds</title>
  <link rel="stylesheet" href="/css/style.css">
  <link rel="icon" href="/favicon.ico" sizes="32x32">
  <link rel="icon" href="/icon.svg" type="image/svg+xml">
  <link rel="canonical" href="https://www.codeworlds.com/cours-html-css">
</head>

Définition et utilisation

#

L’élément <link> décrit la relation entre la page actuelle et une autre ressource. Vous indiquez le type de relation dans l’attribut rel et l’adresse dans href. Le plus souvent, vous ajoutez ainsi un fichier CSS et l’icône de la page (favicon), mais <link> peut aussi accélérer le chargement de ressources ou indiquer au moteur de recherche la bonne adresse de la page.

C’est un élément vide, sans balise fermante, qui se trouve généralement dans <head>. Il n’est ni visible ni cliquable. C’est la différence avec <a> : un lien est destiné à l’utilisateur, alors que <link> est une information pour le navigateur et les robots.

Une feuille de style ajoutée dans l’en-tête suspend l’affichage de la page tant qu’elle n’est pas téléchargée. Cela semble inquiétant, mais c’est voulu : on évite ainsi de voir un instant la page sans styles. Il faut donc veiller à ce que les fichiers CSS soient légers.

Syntaxe

#
Syntaxe
<link rel="relation" href="adresse">

Attributs

#
  • rel

    liste de mots-clés

    Le type de relation avec la ressource, et en même temps l’information sur ce que le navigateur doit en faire. Sans rel, l’élément ne fait rien. Les valeurs les plus importantes sont décrites dans les lignes suivantes de ce tableau.
  • href

    URL

    L’adresse de la ressource, relative (/css/style.css) ou complète (https://…). Sans elle, l’élément ne désigne rien.
  • rel="stylesheet"

    feuille de style CSS

    Ajoute un fichier CSS externe. C’est la méthode la plus répandue pour styliser les pages : un seul fichier sert toutes les sous-pages, et après le premier téléchargement, le navigateur le garde dans son cache. Il n’est pas nécessaire d’ajouter l’attribut type="text/css".
  • media

    requête média

    Applique la feuille de style seulement quand la condition est remplie, par exemple à l’impression (print) ou en mode sombre. Le navigateur télécharge tout de même un fichier dont la condition n’est pas remplie, mais avec une priorité plus basse et sans suspendre l’affichage de la page.
  • rel="icon"

    icône de la page (favicon)

    L’icône visible sur l’onglet du navigateur et dans les favoris. L’attribut sizes indique les dimensions (par exemple 32x32), et type le format du fichier. Un ensemble courant comprend un fichier .ico pour les anciens programmes, une icône SVG qui s’adapte sans perte de qualité, apple-touch-icon (180 × 180 px) pour l’écran d’accueil d’iOS et un manifeste d’application avec des icônes pour Android.
  • rel="preload"

    téléchargement anticipé d’une ressource, avec `as`

    Demande de télécharger une ressource tout de suite, avant que le navigateur ne la découvre lui-même, par exemple une police cachée au fond d’un fichier CSS ou l’image principale de la page. L’attribut as (font, image, style, script, fetch) est obligatoire et indique la nature de la ressource. Les polices exigent aussi l’attribut crossorigin, même lorsqu’elles proviennent de votre propre serveur.
  • rel="preconnect"

    connexion anticipée à un autre serveur

    Établit une connexion avec un serveur depuis lequel vous allez bientôt télécharger des ressources, par exemple un service de polices. Le navigateur s’occupe à l’avance de la recherche d’adresse, de la connexion et du chiffrement, de sorte que le fichier lui-même arrive plus vite. Une version plus légère, dns-prefetch, ne fait que déterminer l’adresse IP du serveur.
  • rel="canonical"

    l’adresse principale de la page

    Indique aux moteurs de recherche l’adresse de référence d’une page quand le même contenu est accessible à plusieurs adresses, par exemple avec des paramètres ?utm_source=… ou avec et sans barre oblique finale. Donnez l’adresse complète. Le moteur de recherche la traitera comme une indication forte, et non comme un ordre absolu.
  • rel="alternate"

    une autre version de la page, par exemple avec `hreflang`

    Désigne une version alternative du même contenu : dans une autre langue (avec l’attribut hreflang) ou dans un autre format, par exemple un flux RSS (avec l’attribut type). La valeur hreflang="x-default" désigne la version par défaut pour les personnes dont vous ne gérez pas la langue séparément.
  • crossorigin

    anonymous | use-credentials

    Télécharge la ressource en mode CORS. anonymous (ou l’attribut seul, sans valeur) n’envoie pas de cookies vers d’autres domaines, use-credentials les envoie. Il est nécessaire pour les polices, pour integrity sur des fichiers d’autres domaines et pour preconnect vers les serveurs d’où vous téléchargez les polices.
  • integrity

    empreinte cryptographique, par exemple `sha384-…`

    Une protection pour les fichiers provenant de serveurs externes, par exemple d’un CDN (Subresource Integrity). Vous indiquez l’empreinte du fichier, et après le téléchargement, le navigateur vérifie qu’elle correspond. Si quelqu’un remplace le fichier sur le serveur, le navigateur le rejette. Pour les fichiers d’un autre domaine, ajoutez aussi crossorigin="anonymous".

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

rel="stylesheet"

feuille de style CSS

Ajoute un fichier CSS externe. C’est la méthode la plus répandue pour styliser les pages : un seul fichier sert toutes les sous-pages, et après le premier téléchargement, le navigateur le garde dans son cache. Il n’est pas nécessaire d’ajouter l’attribut type="text/css".

HTML
<link rel="stylesheet" href="/css/style.css">

media

requête média

Applique la feuille de style seulement quand la condition est remplie, par exemple à l’impression (print) ou en mode sombre. Le navigateur télécharge tout de même un fichier dont la condition n’est pas remplie, mais avec une priorité plus basse et sans suspendre l’affichage de la page.

HTML
<link rel="stylesheet" href="/css/style.css">
<link rel="stylesheet" href="/css/print.css" media="print">
<link rel="stylesheet" href="/css/dark.css" media="(prefers-color-scheme: dark)">

rel="icon"

icône de la page (favicon)

L’icône visible sur l’onglet du navigateur et dans les favoris. L’attribut sizes indique les dimensions (par exemple 32x32), et type le format du fichier. Un ensemble courant comprend un fichier .ico pour les anciens programmes, une icône SVG qui s’adapte sans perte de qualité, apple-touch-icon (180 × 180 px) pour l’écran d’accueil d’iOS et un manifeste d’application avec des icônes pour Android.

HTML
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/apple-touch-icon.png">
<link rel="manifest" href="/manifest.webmanifest">

rel="preload"

téléchargement anticipé d’une ressource, avec `as`

Demande de télécharger une ressource tout de suite, avant que le navigateur ne la découvre lui-même, par exemple une police cachée au fond d’un fichier CSS ou l’image principale de la page. L’attribut as (font, image, style, script, fetch) est obligatoire et indique la nature de la ressource. Les polices exigent aussi l’attribut crossorigin, même lorsqu’elles proviennent de votre propre serveur.

HTML
<link rel="preload" href="/fonts/inter.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/img/hero.webp" as="image">

rel="preconnect"

connexion anticipée à un autre serveur

Établit une connexion avec un serveur depuis lequel vous allez bientôt télécharger des ressources, par exemple un service de polices. Le navigateur s’occupe à l’avance de la recherche d’adresse, de la connexion et du chiffrement, de sorte que le fichier lui-même arrive plus vite. Une version plus légère, dns-prefetch, ne fait que déterminer l’adresse IP du serveur.

HTML
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

rel="canonical"

l’adresse principale de la page

Indique aux moteurs de recherche l’adresse de référence d’une page quand le même contenu est accessible à plusieurs adresses, par exemple avec des paramètres ?utm_source=… ou avec et sans barre oblique finale. Donnez l’adresse complète. Le moteur de recherche la traitera comme une indication forte, et non comme un ordre absolu.

HTML
<link rel="canonical" href="https://www.codeworlds.com/cours-html-css">

rel="alternate"

une autre version de la page, par exemple avec `hreflang`

Désigne une version alternative du même contenu : dans une autre langue (avec l’attribut hreflang) ou dans un autre format, par exemple un flux RSS (avec l’attribut type). La valeur hreflang="x-default" désigne la version par défaut pour les personnes dont vous ne gérez pas la langue séparément.

HTML
<link rel="alternate" hreflang="pl" href="https://www.codeworlds.com/kurs-html">
<link rel="alternate" hreflang="en" href="https://www.codeworlds.com/en/html-course">
<link rel="alternate" hreflang="x-default" href="https://www.codeworlds.com/en/html-course">
<link rel="alternate" type="application/rss+xml" title="Blog CodeWorlds" href="/blog/rss.xml">

integrity

empreinte cryptographique, par exemple `sha384-…`

Une protection pour les fichiers provenant de serveurs externes, par exemple d’un CDN (Subresource Integrity). Vous indiquez l’empreinte du fichier, et après le téléchargement, le navigateur vérifie qu’elle correspond. Si quelqu’un remplace le fichier sur le serveur, le navigateur le rejette. Pour les fichiers d’un autre domaine, ajoutez aussi crossorigin="anonymous".

HTML
<link
  rel="stylesheet"
  href="https://cdn.example.com/reset.min.css"
  integrity="sha384-WDMDqPkpoQaPl6uhHNxkwhv3yB5Ae46EbjyRWmKdfWPSXPigfz2MdYGomGZE9FBE"
  crossorigin="anonymous"
>

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
link {
  display: none;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ajoutez les fichiers CSS avec <link> dans l’en-tête, et non avec @import dans un autre fichier CSS. @import télécharge les feuilles de style l’une après l’autre et ralentit le démarrage de la page.
  • N’abusez pas de preload. Télécharger tôt de nombreux fichiers prend de la bande passante à ce qui est vraiment urgent, et pour une ressource inutilisée, le navigateur affiche un avertissement dans la console.
  • <link> ne crée pas de lien cliquable. Pour cela, utilisez l’élément <a>.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.