CKTIS / HTML
onlanguagechange — obsługa zmiany preferowanych języków
Atrybut onlanguagechange elementu body ustawia procedurę obsługi zdarzenia languagechange obiektu Window. Zdarzenie sygnalizuje zmianę preferowanych języków użytkownika rozpoznawanych przez przeglądarkę, a nie zmianę atrybutu lang dokumentu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onlanguagechange="JavaScript statements">onlanguagechange jest atrybutem obsługi zdarzenia używanym na elemencie body. Jego wartość zawiera kod JavaScript wykonywany dla zdarzenia languagechange obiektu Window; nie jest to zwykłe zdarzenie skierowane do body.
Przeglądarka emituje to zdarzenie, gdy zmienia się rozpoznawana przez nią lista preferowanych języków użytkownika. W procedurze obsługi można odczytać navigator.languages, aby uzyskać uporządkowaną listę preferencji, lub navigator.language, aby uzyskać język najbardziej preferowany. Zmiana atrybutu lang nie oznacza zmiany tych preferencji, a samo zdarzenie nie tłumaczy strony.
W JavaScript tę samą procedurę można ustawić przez window.onlanguagechange. Nowe przypisanie zastępuje poprzednią procedurę w tym miejscu; window.addEventListener('languagechange', handler) pozwala zamiast tego rejestrować niezależne funkcje nasłuchujące. Polityka bezpieczeństwa strony może blokować kod w atrybutach obsługi zdarzeń.
Przykład celowo wysyła syntetyczne zdarzenie do window, aby wynik nie zależał od ustawień językowych urządzenia. Sprawdza uruchomienie procedury, ale nie zmienia preferencji ani nie sprawdza wykrywania rzeczywistej zmiany przez przeglądarkę.
Przykłady
<!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>Wynik
languagechange received
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.