# Falta el atributo lang: el error explicado y corregido

Source: https://allyway.ai/es/glossary/falta-atributo-lang

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](https://www.w3.org/WAI/WCAG22/Understanding/language-of-page.html) es un criterio de nivel A de las [WCAG 2.2](https://allyway.ai/es/regulations/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](https://allyway.ai/es/glossary/subtitulos) | Subtítulos mostrados correctamente |

> **Note:** > **¿Cuál es el idioma «predeterminado»?**
> El W3C lo define como el idioma que más se usa en la página. Si se usan varios idiomas por igual, el predeterminado es el primero que aparece. Los pasajes en otro idioma se rigen por una regla distinta de nivel AA, el criterio 3.1.2 [Idioma de las partes](https://allyway.ai/es/glossary/idioma-de-las-partes).

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

```html title="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>
```

**Do:** 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.

**Don't:** 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](https://allyway.ai/es/regulations/eaa), 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](https://allyway.ai/es/glossary/boton-vacio) en la cabecera o un [nivel de encabezado omitido](https://allyway.ai/es/glossary/nivel-de-encabezado-omitido) en el pie de página.

## Preguntas frecuentes

Q: ¿Qué significa el error «HTML element has no lang attribute»?
A: 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.

Q: ¿Es la falta del atributo lang un incumplimiento de las WCAG?
A: Sí. Incumple el criterio 3.1.1 [Idioma de la página](https://allyway.ai/es/glossary/idioma-de-la-pagina), 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.

Q: ¿Debo usar «en» o «en-US»?
A: 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.

Q: ¿Cada página necesita su propio atributo lang?
A: 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.

Q: ¿Cómo compruebo que no falta el atributo lang en ninguna página?
A: 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](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) lo muestra en el primer análisis, junto con otros problemas de nivel A.
