¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 3.1.1Nivel AComprensible

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

Ejemplo
<!-- 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>
Qué hacer

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.

Qué evitar

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.

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo