Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onlanguagechange — gestire le modifiche delle lingue preferite

L’attributo onlanguagechange su body imposta il gestore dell’oggetto Window per languagechange. L’evento segnala una modifica delle lingue preferite dell’utente secondo il browser, non una modifica dell’attributo lang del documento.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<body onlanguagechange="JavaScript statements">

onlanguagechange è un attributo di contenuto per la gestione degli eventi usato su body. Il suo valore contiene JavaScript eseguito per l’evento languagechange dell’oggetto Window; non è un normale evento indirizzato a body.

Il browser genera questo evento quando cambia la propria interpretazione delle lingue preferite dell’utente. Nel gestore, leggi navigator.languages per ottenere le preferenze in ordine oppure navigator.language per la lingua preferita. Modificare l’attributo lang non significa che siano cambiate queste preferenze, e l’evento da solo non traduce la pagina.

In JavaScript, lo stesso gestore si può impostare tramite window.onlanguagechange. Una nuova assegnazione sostituisce il gestore precedente in quello spazio; window.addEventListener('languagechange', handler) consente invece di registrare listener indipendenti. La politica di sicurezza di una pagina può bloccare il codice negli attributi per la gestione degli eventi.

L’esempio invia deliberatamente un evento sintetico a window, così il risultato non dipende dalle impostazioni linguistiche del dispositivo. Verifica che il gestore venga eseguito, ma non modifica le preferenze né verifica che il browser rilevi un cambiamento reale di tali preferenze.

Esempi

<!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>

Risultato

languagechange received

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti