Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes