Falta el atributo lang: el error explicado y corregido
También llamado: El elemento html no tiene atributo lang, Idioma de la página no definido, Falta el idioma del documento
Definición
La falta del atributo lang significa que el elemento html de una página no tiene atributo lang, o que este está vacío o no es válido. Los navegadores y los lectores de pantalla no pueden saber entonces en qué idioma está escrita la página.
La falta del atributo lang es el error que señalan los escáneres cuando el elemento <html> de una página no declara el idioma de la página. Las herramientas lo muestran como «HTML element has no lang attribute» o «Page language not set» (el elemento html no tiene atributo lang, idioma de la página no definido). La solución es un solo atributo, pero sin él un lector de pantalla puede leer toda su página con las reglas de pronunciación equivocadas.
Qué significa
El criterio WCAG 3.1.1 Idioma de la página es un criterio de nivel A de las WCAG 2.2. Exige que el idioma humano predeterminado de cada página web pueda determinarse por software. En HTML, de eso se encarga el atributo lang del elemento html (técnica H57 del W3C).
Por qué importa: los lectores de pantalla y la síntesis de voz cargan las reglas de pronunciación del idioma declarado. Si no se define el idioma de la página, el software recurre a la voz predeterminada del usuario. Una página en alemán leída por una voz inglesa es difícil de seguir, y al revés ocurre lo mismo. Los navegadores también usan el idioma para mostrar correctamente los caracteres y para la traducción automática, y los reproductores multimedia lo usan para mostrar los subtítulos.
El W3C cita a estos grupos como principales beneficiarios:
| Quién | Qué aporta el atributo lang |
|---|---|
| Usuarios de lectores de pantalla y de síntesis de voz | Pronunciación y voz correctas |
| Personas a quienes les resulta difícil leer texto escrito | La síntesis de voz lee bien las palabras |
| Personas con discapacidad cognitiva, del lenguaje o del aprendizaje | Una lectura en voz alta fiable |
| Personas que dependen de los subtítulos | Subtítulos mostrados correctamente |
Los escáneres también señalan el atributo cuando está presente pero vacío (lang="") o no es una etiqueta de idioma válida. El valor debe seguir la norma BCP 47, es decir, los códigos cortos habituales como en, de o en-GB.
Ejemplos
<!-- Missing lang attribute: language unknown -->
<!DOCTYPE html>
<html>
<head><title>Opening hours</title></head>
<!-- Fixed: English page -->
<html lang="en">
<!-- Fixed: British English with a region subtag -->
<html lang="en-GB">
<!-- A French quote inside the English page (3.1.2) -->
<p>Our motto: <span lang="fr">savoir-faire</span></p>Defina lang en el elemento html de cada página, utilice el idioma en el que está escrita la mayor parte del contenido y asigne a cada versión lingüística de un sitio multilingüe su propio código.
Dejar lang vacío, inventar códigos como lang="english" o copiar el mismo lang="en" en una plantilla traducida cuyo contenido está ahora en alemán.
Cómo corregir la falta del atributo lang
El atributo lang es una de las correcciones más rápidas en cualquier auditoría según la Ley Europea de Accesibilidad, porque normalmente el mismo ajuste ausente afecta a todas las páginas de un sitio. Mientras esté en la plantilla, revise otros problemas que afectan a todo el sitio, como un botón vacío en la cabecera o un nivel de encabezado omitido en el pie de página.
Preguntas frecuentes
¿Qué significa el error «HTML element has no lang attribute»?
La etiqueta <html> de la página no indica en qué idioma está el contenido. Las tecnologías de apoyo lo adivinan o usan su idioma predeterminado, lo que a menudo provoca una pronunciación incorrecta.
¿Es la falta del atributo lang un incumplimiento de las WCAG?
Sí. Incumple el criterio 3.1.1 Idioma de la página, de nivel A, porque el idioma de la página no puede determinarse por software. El nivel A es el nivel mínimo de conformidad con las WCAG.
¿Debo usar «en» o «en-US»?
Ambos son válidos. El código principal (en) cumple las WCAG. Una subetiqueta de región como en-US o en-GB añade un detalle que algunas voces y correctores ortográficos pueden aprovechar, pero es opcional.
¿Cada página necesita su propio atributo lang?
Sí. El criterio se aplica a cada página web, así que todas deben declarar su idioma predeterminado. En la práctica, se define una sola vez en la plantilla común, y cada versión lingüística de la plantilla genera su propio código.
¿Cómo compruebo que no falta el atributo lang en ninguna página?
Las plantillas suelen provocar el error en todo el sitio, así que probar una página por plantilla e idioma es un buen punto de partida. El comprobador WCAG gratuito lo muestra en el primer análisis, junto con otros problemas de nivel A.
Términos relacionados
Falta el atributo alt: el error explicado y corregido
La falta del atributo alt significa que un elemento img (o un botón de imagen o un área de mapa de imagen) no tiene ningún atributo alt. Las tecnologías de apoyo no pueden saber si la imagen es informativa o decorativa y pueden leer en voz alta el nombre del archivo.
Leer la definición: Falta el atributo alt: el error explicado y corregidoBotón vacío: qué significa el error y cómo corregirlo
Un botón vacío es un elemento button sin nombre accesible: sin texto, sin aria-label y sin texto alternativo en una imagen que contenga. Los lectores de pantalla solo anuncian que es un botón, no lo que hace.
Leer la definición: Botón vacío: qué significa el error y cómo corregirloNivel de encabezado omitido: advertencia y cómo corregirla
Un nivel de encabezado omitido es un salto de más de un rango hacia abajo en la jerarquía de encabezados, por ejemplo de un h2 directamente a un h4. Los usuarios de lectores de pantalla que navegan por encabezados pueden pensar que falta una sección.
Leer la definición: Nivel de encabezado omitido: advertencia y cómo corregirlaIdioma de la página: declarar el idioma predeterminado
Idioma de la página es el criterio de conformidad WCAG 3.1.1. Exige que el idioma humano predeterminado de cada página web pueda determinarse por software; en HTML, mediante el atributo lang del elemento html.
Leer la definición: Idioma de la página: declarar el idioma predeterminado