CKTIS / HTML
onlanguagechange — Änderungen bevorzugter Sprachen behandeln
Das Attribut onlanguagechange auf body legt den Handler des Window-Objekts für languagechange fest. Das Ereignis signalisiert eine Änderung der vom Browser erkannten bevorzugten Sprachen des Nutzers, nicht eine Änderung des lang-Attributs des Dokuments.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onlanguagechange="JavaScript statements">onlanguagechange ist ein Event-Handler-Content-Attribut, das auf body verwendet wird. Sein Wert enthält JavaScript, das beim languagechange-Ereignis des Window-Objekts ausgeführt wird; es handelt sich nicht um ein gewöhnliches Ereignis, das an body gerichtet ist.
Der Browser löst dieses Ereignis aus, wenn sich seine Erkennung der bevorzugten Sprachen des Nutzers ändert. Im Handler kannst du navigator.languages für die geordnete Liste der Präferenzen oder navigator.language für die bevorzugte Sprache auslesen. Eine Änderung des lang-Attributs bedeutet nicht, dass sich diese Präferenzen geändert haben, und das Ereignis selbst übersetzt die Seite nicht.
In JavaScript lässt sich derselbe Handler über window.onlanguagechange festlegen. Eine neue Zuweisung ersetzt den vorherigen Handler an dieser Stelle; mit window.addEventListener('languagechange', handler) lassen sich stattdessen unabhängige Listener registrieren. Die Sicherheitsrichtlinie einer Seite kann Code in Event-Handler-Attributen blockieren.
Das Beispiel löst bewusst ein synthetisches Ereignis auf window aus, damit das Ergebnis nicht von den Spracheinstellungen des Geräts abhängt. Es prüft, ob der Handler aufgerufen wird, ändert aber weder Präferenzen noch testet es, ob der Browser eine tatsächliche Präferenzänderung erkennt.
Beispiele
<!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>Ergebnis
languagechange received
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.