# Idioma de la página: declarar el idioma predeterminado

Source: https://allyway.ai/es/glossary/idioma-de-la-pagina

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.

Idioma de la página es la regla de las WCAG según la cual toda página web debe declarar su idioma principal en el código. Los navegadores, las herramientas de traducción y los [lectores de pantalla](https://allyway.ai/es/glossary/lector-de-pantalla) leen esa declaración para elegir las reglas de pronunciación, las fuentes y la separación silábica. Sin ella, una página en alemán puede leerse en voz alta con pronunciación inglesa, y nadie la entenderá.

## 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 de nivel A en las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2): el idioma humano predeterminado de cada página web debe poder determinarse por software. En HTML, la técnica suficiente es H57, es decir, el atributo `lang` del elemento `html`. Un idioma indicado en la cabecera HTTP (SVR5) es solo un complemento orientativo; los lectores de pantalla se basan en el atributo.

El **idioma predeterminado** es el que más se usa en la página. Si se usan varios idiomas por igual, el W3C indica que cuenta el primero que aparece. Las palabras sueltas o los pasajes en otro idioma no forman parte del criterio 3.1.1: pertenecen al criterio 3.1.2 [Idioma de las partes](https://allyway.ai/es/glossary/idioma-de-las-partes).

El W3C cita estos grupos como principales beneficiarios:

| Quién | Qué consigue el idioma declarado de la página |
|---|---|
| Usuarios de lectores de pantalla y de texto a voz | Se cargan las reglas de pronunciación correctas |
| Personas a las que les cuesta leer con fluidez | Las herramientas de lectura en voz alta pronuncian bien las palabras |
| Personas con discapacidad cognitiva, del lenguaje y del aprendizaje | El texto a voz sigue siendo comprensible |
| Usuarios de subtítulos | Los reproductores multimedia muestran los subtítulos correctamente |

> **Note:** > **Idioma de la página frente a atributo lang ausente**
> Idioma de la página es el requisito. «[Falta el atributo lang](https://allyway.ai/es/glossary/falta-atributo-lang)» es el error que muestra un escáner cuando una página lo incumple: no hay `lang`, el valor está vacío o el código no es una etiqueta de idioma real.

Como el criterio 3.1.1 forma parte de la [norma europea EN 301 549](https://allyway.ai/es/regulations/en-301-549) (cláusula 9.3.1.1), también es relevante para la [Ley Europea de Accesibilidad](https://allyway.ai/es/regulations/eaa).

## Ejemplos

```html title="Ejemplo"
<!-- Good: English page, US English -->
<html lang="en-US">

<!-- Good: German page with an English quote -->
<html lang="de">
  ...
  <p>Ihr Slogan: <span lang="en">Made for everyone</span></p>

<!-- Bad: no language declared -->
<html>

<!-- Bad: wrong language – the site is in Spanish -->
<html lang="en">
```

El segundo ejemplo cumple el criterio 3.1.1 porque el idioma de la página es el alemán; el `lang="en"` de la cita es lo que pide el criterio 3.1.2.

**Do:** Qué hacer

Defina `lang` en el elemento `html` de cada plantilla, incluidas las páginas de error, los pasos del proceso de pago y las páginas generadas por plugins. Utilice una etiqueta BCP 47 válida, como `en`, `en-GB`, `de` o `de-AT`, y dé a cada versión de idioma de un sitio multilingüe su propio valor.

**Don't:** Qué evitar

Copiar una misma plantilla con `lang="en"` en todas las versiones de idioma, dejar el valor vacío, usar solo un código de país (`at` no es un idioma) o inventar códigos como `english`.

## Cómo comprobar el idioma de la página



## Preguntas frecuentes

Q: ¿Qué es el idioma de la página en las WCAG?
A: Es el criterio de conformidad 3.1.1, de nivel A. Cada página web debe declarar su idioma humano principal de forma que el software pueda leerlo: en HTML, con el atributo `lang` del elemento `html`.

Q: ¿Dónde se indica el idioma de la página en HTML?
A: En la etiqueta de apertura `html`, por ejemplo `<html lang="en">`. La mayoría de los temas de CMS lo generan a partir del ajuste de idioma del sitio, así que revise primero ese ajuste antes de modificar la plantilla.

Q: ¿Debo usar «en» o «en-US»?
A: Ambos son válidos. El código principal (`en`) basta para el criterio 3.1.1; una región (`en-US`, `en-GB`) resulta útil cuando la ortografía o la pronunciación difieren de un país a otro.

Q: ¿Y si mi página usa dos idiomas?
A: Declare como idioma de la página el que más se use. Marque los pasajes en el otro idioma con su propio atributo `lang`: ese es el criterio 3.1.2 Idioma de las partes.

Q: ¿El idioma de la página influye en el SEO?
A: Los buscadores detectan el idioma sobre todo a partir del contenido, pero un atributo `lang` correcto ayuda a los navegadores a ofrecer la traducción y mantiene la página coherente con su [título de página](https://allyway.ai/es/glossary/titulo-de-pagina) y su [estructura de encabezados](https://allyway.ai/es/glossary/estructura-de-encabezados) para las tecnologías de apoyo.
