CKTIS / HTML
hreflang — idioma do recurso associado
O atributo hreflang indica o idioma de um recurso associado. O seu valor é uma etiqueta de idioma BCP 47 válida e serve apenas como indicação: não define o idioma do documento atual nem substitui as informações linguísticas associadas ao recurso obtido.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<a href="URL" hreflang="language-tag">...</a>
<link rel="alternate" href="URL" hreflang="language-tag">O atributo hreflang descreve o idioma do recurso associado, não o idioma do texto da ligação. O seu valor tem de ser uma etiqueta de idioma BCP 47 válida, como en ou en-GB. Não é um atributo booleano: indique uma etiqueta de idioma, em vez de deixar o valor vazio.
Num elemento a, descreve o destino da hiperligação. Num elemento link, tem o mesmo significado; a combinação de rel="alternate" com hreflang pode identificar uma versão noutro idioma. Por si só, hreflang não estabelece que o recurso seja uma tradução da página atual.
Esta informação é meramente indicativa. Depois de obter o recurso, o navegador tem de determinar o seu idioma com base em informações associadas a esse recurso, e não nos metadados da ligação. Não confunda hreflang com lang, que especifica o idioma do conteúdo de um elemento; o atributo também não traduz texto.
No exemplo, lang="pl" descreve o documento, enquanto as duas ocorrências de hreflang="en" descrevem guide-en.html. O texto visível é English guide; os metadados link não acrescentam uma segunda ligação visível.
Exemplos
<!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>Resultado
English guide
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.