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.