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

Idioma de la página: declarar el idioma predeterminado

También llamado: Idioma de página, Idioma predeterminado, Idioma del documento, html lang

Definición

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 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 es de nivel A en las 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.

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

Como el criterio 3.1.1 forma parte de la norma europea EN 301 549 (cláusula 9.3.1.1), también es relevante para la Ley Europea de Accesibilidad.

Ejemplos

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.

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.

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

    ¿Qué es el idioma de la página en las WCAG?

    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.

    ¿Dónde se indica el idioma de la página en HTML?

    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.

    ¿Debo usar «en» o «en-US»?

    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.

    ¿Y si mi página usa dos idiomas?

    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.

    ¿El idioma de la página influye en el SEO?

    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 y su estructura de encabezados para las tecnologías de apoyo.

    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