CKTIS / HTML
hreflang — langue de la ressource liée
L’attribut hreflang indique la langue d’une ressource liée. Sa valeur est une étiquette de langue BCP 47 valide et sert uniquement d’indication : elle ne définit pas la langue du document courant et ne remplace pas les informations linguistiques associées à la ressource récupérée.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<a href="URL" hreflang="language-tag">...</a>
<link rel="alternate" href="URL" hreflang="language-tag">L’attribut hreflang décrit la langue de la ressource liée, et non celle du texte du lien. Sa valeur doit être une étiquette de langue BCP 47 valide, comme en ou en-GB. Ce n’est pas un attribut booléen : indiquez une étiquette de langue plutôt qu’une valeur vide.
Sur un élément a, il décrit la destination du lien hypertexte. Sur un élément link, il a le même sens ; associer rel="alternate" à hreflang peut désigner une version dans une autre langue. À lui seul, hreflang ne permet pas d’établir que la ressource est une traduction de la page courante.
Cette information est uniquement indicative. Après avoir récupéré la ressource, le navigateur doit déterminer sa langue à partir des informations associées à cette ressource, et non des métadonnées du lien. Ne confondez pas hreflang avec lang, qui précise la langue du contenu d’un élément ; cet attribut ne traduit pas non plus le texte.
Dans l’exemple, lang="pl" décrit le document, tandis que les deux occurrences de hreflang="en" décrivent guide-en.html. Le texte visible est English guide ; les métadonnées link n’ajoutent pas un deuxième lien visible.
Exemples
<!doctype html>
<html lang="pl">
<head>
<meta charset="utf-8">
<title>hreflang</title>
<link rel="alternate" href="guide-en.html" hreflang="en">
</head>
<body>
<a href="guide-en.html" hreflang="en">English guide</a>
</body>
</html>Résultat
English guide
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.