Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

hreflang — idioma del recurso enlazado

El atributo hreflang indica el idioma de un recurso enlazado. Su valor es una etiqueta de idioma BCP 47 válida y sirve solo como sugerencia: no establece el idioma del documento actual ni sustituye la información lingüística asociada al recurso obtenido.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

El atributo hreflang describe el idioma del recurso enlazado, no el idioma del texto del enlace. Su valor debe ser una etiqueta de idioma BCP 47 válida, como en o en-GB. No es un atributo booleano: indica una etiqueta de idioma, no un valor vacío.

En un elemento a, describe el destino del hipervínculo. En un elemento link, tiene el mismo significado; combinar rel="alternate" con hreflang permite identificar una versión en otro idioma. Por sí solo, hreflang no demuestra que el recurso sea una traducción de la página actual.

La información es meramente orientativa. Una vez obtenido el recurso, el navegador debe determinar su idioma a partir de la información asociada a ese recurso, no de los metadatos del enlace. No confundas hreflang con lang, que especifica el idioma del contenido de un elemento; el atributo tampoco traduce el texto.

En el ejemplo, lang="pl" describe el documento, mientras que las dos apariciones de hreflang="en" describen guide-en.html. El texto visible es English guide; los metadatos de link no añaden un segundo enlace visible.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes