CKTIS / HTML
onlanguagechange — обработване на промени в предпочитаните езици
Атрибутът onlanguagechange върху body задава обработчика на обекта Window за languagechange. Събитието сигнализира за промяна в предпочитаните езици на потребителя според разпознаването на браузъра, а не за промяна на атрибута lang на документа.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<body onlanguagechange="JavaScript statements">onlanguagechange е съдържателен атрибут за обработчик на събитие, използван върху body. Стойността му съдържа JavaScript, който се изпълнява при събитието languagechange на обекта Window; това не е обикновено събитие, насочено към body.
Браузърът задейства това събитие, когато се промени разбирането му за предпочитаните езици на потребителя. В обработчика прочети navigator.languages, за да получиш подредените предпочитания, или navigator.language, за да получиш предпочитания език. Промяната на атрибута lang не означава, че тези предпочитания са се променили, а самото събитие не превежда страницата.
В JavaScript същият обработчик може да бъде зададен чрез window.onlanguagechange. Ново присвояване заменя предишния обработчик на това място; window.addEventListener('languagechange', handler) позволява вместо това да се регистрират независими слушатели. Политиката за сигурност на страницата може да блокира код в атрибутите за обработчици на събития.
Примерът умишлено изпраща синтетично събитие към window, така че резултатът да не зависи от езиковите настройки на устройството. Той проверява извикването на обработчика, но не променя предпочитанията и не проверява дали браузърът открива реална промяна в тях.
Примери
<!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>Резултат
languagechange received
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.