Desarrollo web · Buenas prácticas

Cómo indicar el idioma de tu web con lang en HTML

Aprende a declarar el idioma principal de una página y a marcar fragmentos en otra lengua para facilitar su lectura con tecnologías de asistencia.

Página en español con un fragmento en inglés identificado por separado.

Para indicar que una página está escrita en español, añade lang="es" al elemento raíz html. Si dentro aparece un párrafo en inglés, marca ese fragmento con lang="en". Así proporcionas información que los lectores de pantalla pueden utilizar para elegir la pronunciación adecuada, sin cambiar el aspecto del contenido.

No necesitas instalar una biblioteca ni traducir toda la web para hacerlo. En esta guía trabajarás con un archivo HTML de ejemplo y aprenderás a distinguir el idioma general de los cambios locales. El atributo describe el texto que ya existe: no lo traduce automáticamente.

Qué resuelve declarar el idioma

Una persona puede reconocer visualmente que un artículo está en español, pero el software necesita una indicación explícita. Según la documentación de MDN sobre el elemento raíz html, declarar un idioma válido ayuda a los lectores de pantalla a anunciar el contenido correctamente. Sin esa indicación, pueden recurrir al idioma del sistema operativo y producir una pronunciación inadecuada.

Colocarlo en la raíz también abarca el título de la pestaña, que está fuera del cuerpo visible. Es una mejora concreta de accesibilidad, pero no garantiza por sí sola que toda la página sea accesible: siguen importando los encabezados, las etiquetas de formularios y el funcionamiento con teclado.

Declara el idioma principal paso a paso

Para practicar, utiliza un editor de texto y un navegador. Crea un archivo independiente llamado idioma-demo.html; así puedes revisar el resultado sin modificar una página publicada. El siguiente ejemplo representa una página ficticia de un taller.

  1. Copia el documento del ejemplo en el archivo nuevo.

  2. Comprueba que lang="es" esté en la apertura del elemento html, no únicamente en un párrafo.

  3. Guarda el archivo con codificación UTF-8 y ábrelo en el navegador.

<!doctype html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Taller de páginas web</title>
</head>
<body>
  <h1>Taller de páginas web</h1>
  <p>Aprende a construir una página sencilla.</p>
  <p lang="en">No previous experience is required.</p>
  <p>El taller incluye ejercicios guiados.</p>
</body>
</html>

El resultado esperado es una página con un encabezado y tres párrafos. No aparecerá una bandera ni un selector de idioma: lang es información del documento, no un componente visual. La frase inglesa significa que no se requiere experiencia previa.

Elige el código según el contenido

El valor utiliza una etiqueta de idioma BCP 47. Para este ejemplo basta es, correspondiente al español; en identifica el inglés. No escribas el nombre completo del idioma, como español, dentro del atributo. Puedes añadir una región cuando exista una razón concreta para distinguir una variante, pero no es necesario hacerlo solo porque el sitio se administre desde Perú.

Elige el idioma predominante del texto, no el país del servidor ni el idioma de tu editor. Si creas otra página cuyo contenido principal esté en inglés, esa página necesita su propia declaración acorde con el contenido.

Marca los fragmentos escritos en otro idioma

El idioma se hereda: un elemento sin declaración propia utiliza el de su elemento padre. Por eso no hace falta repetir lang="es" en cada encabezado y párrafo. La referencia de MDN sobre el atributo lang explica esta herencia y la importancia de identificar las partes redactadas en otras lenguas.

El idioma español se hereda desde la raíz; un párrafo en inglés cambia solo su propia rama.

En el documento anterior, solo el segundo párrafo cambia al inglés. El tercero sigue heredando el español de la raíz: el cambio no se extiende a los elementos hermanos. Si lo que cambia es una frase dentro de un párrafo, puedes delimitarla mediante span.

<p>
  El mensaje de bienvenida dice:
  <span lang="en">Welcome to the workshop.</span>
  Después comienza la presentación en español.
</p>

Aplica la declaración al contenedor que abarque exactamente el fragmento. Si una cita completa está en inglés, resulta más claro marcar su contenedor que añadir el atributo palabra por palabra. Evita incluir accidentalmente la explicación española dentro de ese mismo elemento.

Comprueba la declaración y sus límites

Abre las herramientas de desarrollo del navegador desde la opción Inspeccionar y busca el elemento html en el panel de elementos. Confirma que conserva lang="es". Después localiza el párrafo inglés y comprueba que lleva su declaración específica. Esta revisión permite detectar plantillas que hayan dejado el idioma predeterminado equivocado.

Si dispones de un lector de pantalla, recorre ambos fragmentos y escucha cómo los anuncia. La respuesta puede depender de las voces instaladas y de la configuración de cambio de idioma. Que no escuches una diferencia no demuestra, por sí solo, que el atributo esté mal escrito.

Esta comprobación complementa la guía para revisar si una web se puede usar con teclado: una revisión observa cómo se identifica el idioma y la otra cómo se recorren y activan los controles. Ninguna sustituye a la otra.

Errores habituales que conviene corregir

  • Conservar lang="en" de una plantilla inglesa. Revisa la raíz cuando sustituyas el contenido de ejemplo por texto español.

  • Dejar lang vacío. Un valor vacío indica idioma desconocido; no significa que el navegador deba traducir o detectar correctamente el texto.

  • Confundir idioma y codificación. UTF-8 permite representar caracteres como tildes y eñes; no declara que el contenido esté en español.

  • Esperar una traducción o un cambio de diseño. El texto permanece igual. Para ofrecer una versión traducida necesitas preparar ese contenido por separado.

La revisión final es sencilla: declara el idioma predominante en la raíz, identifica los fragmentos que cambien de lengua y comprueba el HTML que recibe el navegador. No hace falta llenar el documento de atributos repetidos para expresar esa información.