KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onlanguagechange — wijzigingen in voorkeurstalen afhandelen

Het attribuut onlanguagechange op body stelt de handler van het Window-object voor languagechange in. De gebeurtenis geeft aan dat de voorkeurstalen van de gebruiker volgens de browser zijn veranderd, niet dat het lang-attribuut van het document is gewijzigd.

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

Syntax

<body onlanguagechange="JavaScript statements">

onlanguagechange is een contentattribuut voor een gebeurtenishandler dat op body wordt gebruikt. De waarde bevat JavaScript dat wordt uitgevoerd bij de languagechange-gebeurtenis van het Window-object; dit is geen gewone gebeurtenis die op body is gericht.

De browser activeert deze gebeurtenis wanneer zijn interpretatie van de voorkeurstalen van de gebruiker verandert. Lees in de handler navigator.languages voor de geordende voorkeuren of navigator.language voor de voorkeurstaal. Een wijziging van het lang-attribuut betekent niet dat deze voorkeuren zijn veranderd, en de gebeurtenis vertaalt de pagina niet zelf.

In JavaScript kan dezelfde handler worden ingesteld via window.onlanguagechange. Een nieuwe toewijzing vervangt de vorige handler op die plek; met window.addEventListener('languagechange', handler) kunnen in plaats daarvan onafhankelijke luisteraars worden geregistreerd. Het beveiligingsbeleid van een pagina kan code in event-handlerattributen blokkeren.

Het voorbeeld verstuurt bewust een synthetische gebeurtenis naar window, zodat het resultaat niet afhankelijk is van de taalinstellingen van het apparaat. Het controleert of de handler wordt aangeroepen, maar wijzigt de voorkeuren niet en test niet of de browser een echte voorkeurswijziging detecteert.

Voorbeelden

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

Resultaat

languagechange received

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen