Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onlanguagechange — gestionar cambios en los idiomas preferidos

El atributo onlanguagechange de body establece el controlador del objeto Window para languagechange. El evento indica un cambio en los idiomas preferidos del usuario según los reconoce el navegador, no un cambio en el atributo lang del documento.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<body onlanguagechange="JavaScript statements">

onlanguagechange es un atributo de contenido de controlador de eventos que se utiliza en body. Su valor contiene JavaScript que se ejecuta cuando se produce el evento languagechange del objeto Window; no es un evento normal dirigido a body.

El navegador emite este evento cuando cambia su interpretación de los idiomas preferidos del usuario. Dentro del controlador, lee navigator.languages para obtener las preferencias ordenadas o navigator.language para consultar el idioma preferido. Cambiar el atributo lang no significa que hayan cambiado estas preferencias, y el evento por sí mismo no traduce la página.

En JavaScript, se puede establecer el mismo controlador mediante window.onlanguagechange. Una nueva asignación reemplaza el controlador anterior en ese espacio; en cambio, window.addEventListener('languagechange', handler) permite registrar escuchas independientes. La política de seguridad de una página puede bloquear el código de los atributos controladores de eventos.

El ejemplo envía deliberadamente un evento sintético a window para que el resultado no dependa de los ajustes de idioma del dispositivo. Comprueba que se invoque el controlador, pero no cambia las preferencias ni prueba que el navegador detecte un cambio real de preferencias.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onlanguagechange demo</title>
</head>
<body onlanguagechange="document.getElementById('status').textContent = 'languagechange received'">
  <p id="status">Waiting</p>
  <button type="button" id="test">Test</button>
  <script>
    document.getElementById('test').addEventListener('click', () => {
      window.dispatchEvent(new Event('languagechange'));
    });
  </script>
</body>
</html>

Resultado

languagechange received

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes