Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in EnglishAlways switch to English

Attribut HTML : rel

L'attributrel définit la relation entre une ressource liée et le document courant. Il est valide sur<link>,<a>,<area> et<form>. Les valeurs acceptées dépendent de l'élément sur lequel l'attribut est utilisé.

Le type de relation est donné par la valeur de l'attributrel, qui, si elle est présente, doit avoir une valeur qui est un ensemble non ordonné de mots-clés uniques séparés par des espaces. Contrairement à un nom declass, qui n'exprime pas de sémantique, l'attributrel doit exprimer des jetons qui sont sémantiquement valides à la fois pour les machines et les humain·e·s. Les registres actuels pour les valeurs possibles de l'attributrel sontregistre IANA des relations de liens^(angl.),Standard vivant HTML^(angl.), et la page librement modifiableexisting-rel-values^(angl.) du wiki microformats, commesuggéré^(angl.) par le Standard vivant. Si une valeur d'attributrel qui n'est présente dans aucune des trois sources ci-dessus est utilisée, certains validateurs HTML (commeService de validation du balisage W3C^(angl.)) généreront un avertissement.

Le tableau suivant présente quelques-uns des mots-clés existants les plus importants. Chaque mot-clé dans une valeur séparée par des espaces doit être unique dans cette valeur.

Valeur pour`rel`	Description	`<link>`	`<a>` and`<area>`	`<form>`
`alternate`	Représentations alternatives du document actuel.	Lien	Lien	Non autorisé
`author`	Auteur du document ou de l'article en cours.	Lien	Lien	Non autorisé
`bookmark`	Lien permanent pour la section de l'ancêtre le plus proche.	Non autorisé	Lien	Non autorisé
`canonical`	URL préférée pour le document actuel.	Lien	Non autorisé	Non autorisé
`compression-dictionary`	Lien vers undictionnaire de compression qui peut être utilisé pour compresser les téléchargements futurs des ressources de ce site.	Lien	Non autorisé	Non autorisé
`dns-prefetch`	Indique au navigateur d'effectuer de manière préemptive la résolution DNS pour l'origine de la ressource cible.	Ressource externe	Non autorisé	Non autorisé
`external`	Le document référencé ne fait pas partie du même site que le document actuel.	Non autorisé	Annotation	Annotation
`expect`	Lorsqu'il est utilisé avec`blocking="render"`, permet à la page d'êtrebloquante pour le rendu jusqu'à ce que les parties essentielles du document soient analysées pour que la page s'affiche de façon cohérente.	Lien	Non autorisé	Non autorisé
`help`	Lien vers l'aide contextuelle.	Lien	Lien	Lien
`icon`	Une icône représentant le document actuel.	Ressource externe	Non autorisé	Non autorisé
`license`	Indique que le contenu principal du document actuel est couvert par la licence de copyright décrite par le document référencé.	Lien	Lien	Lien
`manifest`	Manifeste de l'application web.	Lien	Non autorisé	Non autorisé
`me`	Indique que le document actuel représente la personne qui possède le contenu lié.	Lien	Lien	Non autorisé
`modulepreload`	Indique au navigateur de récupérer le script de manière préemptive et de le stocker dans la carte des modules du document pour une évaluation ultérieure. En option, les dépendances du module peuvent également être récupérées.	Ressource externe	Non autorisé	Non autorisé
`next`	Indique que le document actuel fait partie d'une série et que le document suivant dans la série est le document référencé.	Lien	Lien	Lien
`nofollow`	Indique que l'auteur ou l'éditeur original du document actuel n'approuve pas le document référencé.	Non autorisé	Annotation	Annotation
`noopener`	Crée un contexte de navigation de haut niveau qui n'est pas un contexte de navigation auxiliaire si l'hyperlien créerait l'un ou l'autre, pour commencer (c'est-à-dire qu'il a une valeur d'attribut`target` appropriée).	Non autorisé	Annotation	Annotation
`noreferrer`	Aucun en-tête`Referer` ne sera inclus. En outre, a le même effet que`noopener`.	Non autorisé	Annotation	Annotation
`opener`	Crée un contexte de navigation auxiliaire si l'hyperlien créerait autrement un contexte de navigation de premier niveau qui n'est pas un contexte de navigation auxiliaire (c'est-à-dire qui a « `_blank` » comme valeur d'attribut`target`).	Non autorisé	Annotation	Annotation
`pingback`	Donne l'adresse du serveur de retour d'appel qui gère les retours d'appel pour le document actuel.	Ressource externe	Non autorisé	Non autorisé
`preconnect`	Définit que l'agent utilisateur doit se connecter de manière préemptive à l'origine de la ressource cible.	Ressource externe	Non autorisé	Non autorisé
`prefetch`	Définit que l'agent utilisateur doit récupérer et mettre en cache de manière préemptive la ressource cible, car elle est susceptible d'être requise pour une navigation ultérieure.	Ressource externe	Non autorisé	Non autorisé
`preload`	Définit que l'agent utilisateur doit récupérer et mettre en cache de manière préemptive la ressource cible pour la navigation actuelle en fonction de la destination potentielle donnée par l'attribut`as` (et la priorité associée à la destination correspondante).	Ressource externe	Non autorisé	Non autorisé
`prerender`Obsolète	Définit que l'agent utilisateur doit récupérer de manière préemptive la ressource cible et la traiter de manière à fournir une réponse plus rapide à l'avenir.	Ressource externe	Non autorisé	Non autorisé
`prev`	Indique que le document actuel fait partie d'une série et que le document précédent dans la série est le document référencé.	Lien	Lien	Lien
`privacy-policy`	Donne un lien vers une information sur les pratiques de collecte et d'utilisation des données qui s'appliquent au document actuel.	Lien	Lien	Non autorisé
`search`	Donne un lien vers une ressource qui peut être utilisée pour effectuer une recherche dans le document actuel et ses pages connexes.	Lien	Lien	Lien
`stylesheet`	Importe une feuille de style.	Ressource externe	Non autorisé	Non autorisé
`tag`	Donne une balise (identifiée par l'adresse donnée) qui s'applique au document actuel.	Non autorisé	Lien	Non autorisé
`terms-of-service`	Lien vers l'accord, ou les conditions d'utilisation, entre le fournisseur du document et les utilisateur·ice·s qui souhaitent utiliser le document.	Lien	Lien	Non autorisé

L'attributrel est pertinent pour les éléments HTML<link>,<a>,<area> et<form>, mais certaines valeurs ne concernent qu'un sous-ensemble de ces éléments. Comme toutes les valeurs d'attribut de mot-clé HTML, ces valeurs ne sont pas sensibles à la casse.

L'attributrel n'a pas de valeur par défaut. Si l'attribut est omis ou si aucune des valeurs de l'attribut n'est prise en charge, alors le document n'a pas de relation particulière avec la ressource de destination, à part le fait qu'il existe un lien hypertexte entre les deux. Dans ce cas, sur<link> et<form>, si l'attributrel est absent, ne contient aucun mot-clé, ou si aucun des mots-clés séparés par des espaces ci-dessus n'est présent, alors l'élément ne crée aucun lien.<a> et<area> créeront tout de même des liens, mais sans relation définie.

Valeurs

alternate

Indique une représentation alternative du document actuel. Valide pour<link>,<a> et<area>, la signification dépend des autres attributs présents.

Avec le mot-cléstylesheet sur un<link>, cela crée unefeuille de style alternative.

html

<!-- feuille de style persistante --><link rel="stylesheet" href="default.css" /><!-- feuilles de style alternatives --><link  rel="alternate stylesheet"  href="highcontrast.css"  title="Contraste élevé" />

Avec un attributhreflang différent de la langue du document, cela indique une traduction.
Avec l'attributtype ayant la valeur"application/rss+xml" ou"application/atom+xml", cela crée un lien vers un flux de syndication.
html
```
<link  rel="alternate"  type="application/atom+xml"  href="posts.xml"  title="Blog" />
```
Sinon, cela crée un lien vers une représentation alternative du document actuel, dont la nature est donnée par les attributshreflang ettype.
- Sihreflang est présent avecalternate et que la valeur dehreflang est différente de la langue du document, cela indique que le document référencé est une traduction.
- Sitype est présent avecalternate, cela indique que le document référencé est dans un format alternatif (comme un PDF).
- Les attributshreflang ettype peuvent être présents ensemble avecalternate.
html
```
<link  rel="alternate"  href="/fr/html/print"  hreflang="fr"  type="text/html"  media="print"  title="HTML français (pour impression)" /><link  rel="alternate"  href="/fr/pdf"  hreflang="fr"  type="application/pdf"  title="PDF français" />
```

author

Indique que le document référencé fournit des informations supplémentaires sur l'auteur·ice du document ou de l'article en cours. Pertinent pour<link>,<a> et<area>.

Avec<a> et<area>, cela indique que le document lié (oumailto:) fournit des informations sur l'auteur·ice de l'ancêtre<article> le plus proche s'il existe, sinon sur l'ensemble du document.

Avec<link>, cela représente l'auteur·ice de l'ensemble du document.

Note :Pour des raisons historiques, la valeur d'attribut obsolèterev="made" est traitée commerel="author".

bookmark

Pertinent comme valeur de l'attributrel pour les éléments<a> et<area>. Donne un lien permanent pour l'élément parent<article> le plus proche, s'il existe. S'il n'y a pas d'élément<article> parent, donne un lien permanent pour la section à laquelle l'élément de liaison est le plus associé.

canonical

Valide pour<link>, définit l'URL préférée pour le document actuel, ce qui aide les moteurs de recherche à réduire le contenu dupliqué.

compression-dictionaryExpérimental

Valide pour<link>, définit undictionnaire de compression qui peut être utilisé pour compresser les téléchargements futurs des ressources de ce site afin que la taille des téléchargements soit plus petite qu'avec une compression standard.

dns-prefetch

Pertinent pour l'élément<link> aussi bien dans le<body> que dans le<head>, indique au navigateur d'effectuer de manière préemptive la résolution DNS pour l'origine de la ressource cible. Utile pour les ressources dont l'utilisateur·ice aura probablement besoin, cela permet de réduire la latence et d'améliorer les performances lorsque l'utilisateur·ice accède effectivement à la ressource, car le navigateur aura déjà effectué la résolution DNS pour l'origine de la ressource spécifiée. Voirdns-prefetch décrit dansresource hints^(angl.).

external

Pertinent pour<form>,<a> et<area>, indique que le document référencé ne fait pas partie du site actuel. Cela peut être utilisé avec des sélecteurs d'attributs pour mettre en forme les liens externes afin d'indiquer à l'utilisateur·ice qu'il·elle va quitter le site actuel.

expectExpérimental

Permet à la page d'êtrebloquante pour le rendu jusqu'à ce que les parties essentielles du document soient analysées pour qu'elle s'affiche de façon cohérente. À noter que le blocage du rendu n'a lieu que si l'attributblocking="render" est également utilisé.

Note :VoirStabiliser l'état de la page pour rendre les transitions inter-documents cohérentes pour plus d'informations sur son utilisation.

help

Pertinent pour<form>,<link>,<a> et<area>, le mot-cléhelp indique que le contenu lié fournit une aide contextuelle, donnant des informations pour le parent de l'élément définissant l'hyperlien et ses enfants. Lorsqu'il est utilisé dans un<link>, l'aide concerne l'ensemble du document. Lorsqu'il est inclus avec<a> et<area> et pris en charge, le curseur (cursor) par défaut serahelp au lieu depointer.

icon

Valide avec<link>, la ressource liée représente l'icône, une ressource pour représenter la page dans l'interface utilisateur, pour le document actuel.

L'utilisation la plus courante de la valeuricon est le favicon :

html

<link rel="icon" href="favicon.ico" />

S'il y a plusieurs<link rel="icon">, le navigateur utilise leurs attributsmedia,type etsizes pour sélectionner l'icône la plus appropriée. Si plusieurs icônes sont également appropriées, la dernière est utilisée. Si l'icône la plus appropriée s'avère inappropriée, par exemple parce qu'elle utilise un format non pris en charge, le navigateur passe à la suivante la plus appropriée, et ainsi de suite.

Note :L'attributcrossorigin n'est pas pris en charge pourrel="icon" dans les navigateurs basés sur Chromium. Voir leproblème ouvert pour Chromium^(angl.).

Note :iOS d'Apple n'utilise pas ce type de lien, ni l'attributsizes, comme le font d'autres navigateurs mobiles, pour sélectionner une icône de page Web pour Web Clip ou un écran de démarrage. À la place, il utilise les liens non standardapple-touch-icon^(angl.) etapple-touch-startup-image^(angl.) respectivement.

Note :Le type de lienshortcut est souvent vu avanticon, mais ce type de lien n'est pas conforme, ignoré etles auteur·ice·s web ne doivent plus l'utiliser.

license

Valide sur les éléments HTML<a>,<area>,<form>,<link>, la valeurlicense indique que le lien mène à un document décrivant les informations de licence ; le contenu principal du document actuel est couvert par la licence de copyright décrite par le document référencé. Si l'élément n'est pas dans le<head>, la norme ne distingue pas si le lien s'applique à une partie spécifique du document ou à l'ensemble du document. Seules les données de la page peuvent l'indiquer.

html

<link rel="license" href="#license" />

Note :Bien que reconnu, le synonymecopyright est incorrect et doit être évité.

manifest

Manifeste d'application web. Nécessite l'utilisation du protocole CORS pour la récupération inter-origine.

modulepreload

Utile pour améliorer les performances, et pertinent pour<link> n'importe où dans le document, définirrel="modulepreload" indique au navigateur de récupérer de manière préemptive le script (et ses dépendances) et de le stocker dans la carte des modules du document pour une évaluation ultérieure. Les liensmodulepreload permettent de s'assurer que le chargement réseau est effectué avec le module prêt (mais non évalué) dans la carte des modules avant qu'il ne soit nécessaire. Voir aussimodulepreload.

next

Pertinent pour<form>,<link>,<a> et<area>, la valeurnext indique que le document actuel fait partie d'une série et que le document suivant dans la série est le document référencé. Lorsqu'il est inclus dans un<link>, les navigateurs peuvent supposer que le document sera récupéré ensuite et le traiter comme une indication de ressource.

nofollow

Pertinent pour<form>,<a> et<area>, le mot-clénofollow indique aux robots des moteurs de recherche d'ignorer la relation du lien. La relation nofollow peut indiquer que le propriétaire du document actuel ne cautionne pas le document référencé. Il est souvent inclus par les spécialistes du référencement qui prétendent que leurs fermes de liens ne sont pas des pages de spam.

noopener

Pertinent pour<form>,<a> et<area>, crée un contexte de navigation de haut niveau qui n'est pas un contexte de navigation auxiliaire si l'hyperlien créerait l'un ou l'autre au départ (c'est-à-dire qu'il a une valeur d'attributtarget appropriée). Autrement dit, cela fait que le lien se comporte comme siwindow.opener était nul et quetarget="_parent" était défini.

Ceci est l'opposé deopener.

noreferrer

Pertinent pour<form>,<a> et<area>, inclure cette valeur rend le référent inconnu (aucun en-têteReferer ne sera inclus), et crée un contexte de navigation de haut niveau comme sinoopener était également défini.

opener

Crée un contexte de navigation auxiliaire si l'hyperlien créerait autrement un contexte de navigation de premier niveau qui n'est pas un contexte de navigation auxiliaire (c'est-à-dire qui a"_blank" comme valeur d'attributtarget). Effectivement, c'est l'opposé denoopener.

pingback

Donne l'adresse du serveur de retour d'appel (pingback) qui gère les retours d'appel pour le document actuel. Voir laspécification Pingback^(angl.).

preconnect

Fournit une indication au navigateur suggérant d'ouvrir une connexion au site web lié à l'avance, sans divulguer d'information privée ni télécharger de contenu, afin que lorsque le lien est suivi, le contenu lié puisse être récupéré plus rapidement.

prefetch

Définit que l'agent utilisateur doit récupérer et mettre en cache de manière préemptive la ressource cible, car elle est susceptible d'être requise pour une navigation ultérieure.Voirprefetch pour plus d'informations.

preload

Définit que l'agent utilisateur doit récupérer et mettre en cache de manière préemptive la ressource cible pour la navigation actuelle en fonction de la destination potentielle donnée par l'attributas (et la priorité associée à la destination correspondante). Voir la page pour la valeurpreload.

prerenderObsolète Non standard

Définit que l'agent utilisateur doit récupérer de manière préemptive la ressource cible et la traiter de façon à fournir une réponse plus rapide à l'avenir, par exemple en récupérant ses sous-ressources ou en effectuant un rendu. Cette fonctionnalité est remplacée par laSpeculation Rules API^(angl.).

prev

Semblable au mot-clénext, pertinent pour<form>,<link>,<a> et<area>, la valeurprev indique que le document actuel fait partie d'une série et que le lien référence un document précédent dans la série.

Remarque : Le synonymeprevious est incorrect et ne doit pas être utilisé.

privacy-policy

Valide pour les éléments HTML<a>,<area> et<link>, la valeurprivacy-policy indique que le document référencé est la politique de confidentialité qui décrit les pratiques de collecte et d'utilisation des données du document actuel.

search

Pertinent pour les éléments HTML<form>,<link>,<a> et<area>, le mot-clésearch indique que l'hyperlien référence un document dont l'interface est spécialement conçue pour effectuer des recherches dans le document actuel, le site et les ressources associées, fournissant un lien vers une ressource qui peut être utilisée pour la recherche.

Si l'attributtype est défini surapplication/opensearchdescription+xml, la ressource est un pluginOpenSearch^(angl.) qui peut être facilement ajouté à l'interface de Firefox.

stylesheet

Valide pour l'élément HTML<link>, il importe une ressource externe à utiliser comme feuille de style. L'attributtype n'est pas nécessaire s'il s'agit d'une feuille de styletext/css, car c'est la valeur par défaut. Si ce n'est pas une feuille de style de typetext/css, il est préférable de déclarer le type.

Bien que cet attribut définisse le lien comme étant une feuille de style, l'interaction avec d'autres attributs et autres termes clés dans la valeur derel influence si la feuille de style est téléchargée et/ou utilisée.

Lorsqu'il est utilisé avec le mot-cléalternate, il définit une feuille de style alternative. Dans ce cas, inclure un attributtitle non vide.

La feuille de style externe ne sera pas utilisée ni même téléchargée si le média ne correspond pas à la valeur de l'attributmedia.

Nécessite l'utilisation du protocole CORS pour la récupération inter-origine.

tag

Valide pour les éléments HTML<a> et<area>, il donne une balise (identifiée par l'adresse donnée) qui s'applique au document actuel. La valeur de balise indique que le lien fait référence à un document décrivant une balise s'appliquant au document sur lequel il se trouve. Ce type de lien n'est pas destiné aux balises dans un nuage de tags, car ces balises s'appliquent à un groupe de pages, tandis que la valeurtag de l'attributrel concerne un seul document.

terms-of-service

Valide pour les éléments HTML<a>,<area> et<link>, la valeurterms-of-service indique que le document référencé est les conditions d'utilisation qui décrivent les accords entre le fournisseur du document actuel et les utilisateur·ice·s qui souhaitent utiliser le document fourni.