Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

hreflang — lingua della risorsa collegata

L’attributo hreflang indica la lingua di una risorsa collegata. Il suo valore è un tag di lingua BCP 47 valido e costituisce solo un suggerimento: non imposta la lingua del documento corrente né sostituisce le informazioni linguistiche associate alla risorsa recuperata.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<a href="URL" hreflang="language-tag">...</a>
<link rel="alternate" href="URL" hreflang="language-tag">

L’attributo hreflang descrive la lingua della risorsa collegata, non quella del testo del collegamento. Il suo valore deve essere un tag di lingua BCP 47 valido, come en o en-GB. Non è un attributo booleano: specifica un tag di lingua, anziché lasciare il valore vuoto.

Su un elemento a, descrive la destinazione del collegamento ipertestuale. Su un elemento link ha lo stesso significato; combinare rel="alternate" con hreflang può identificare una versione in un’altra lingua. Da solo, hreflang non stabilisce che la risorsa sia una traduzione della pagina corrente.

L’informazione è puramente indicativa. Dopo aver recuperato la risorsa, il browser deve determinarne la lingua usando informazioni associate a quella risorsa, non i metadati del collegamento. Non confondere hreflang con lang, che specifica la lingua del contenuto di un elemento; l’attributo non traduce il testo.

Nell’esempio, lang="pl" descrive il documento, mentre entrambe le occorrenze di hreflang="en" descrivono guide-en.html. Il testo visibile è English guide; i metadati link non aggiungono un secondo collegamento visibile.

Esempi

<!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>

Risultato

English guide

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti