CKTIS / HTML
onlanguagechange — obrada promjena preferiranih jezika
Atribut onlanguagechange na body postavlja rukovatelj objekta Window za događaj languagechange. Događaj označava promjenu korisnikovih preferiranih jezika prema prepoznavanju preglednika, a ne promjenu atributa lang dokumenta.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onlanguagechange="JavaScript statements">onlanguagechange je sadržajni atribut rukovatelja događaja koji se upotrebljava na body. Njegova vrijednost sadrži JavaScript koji se izvršava pri događaju languagechange objekta Window; to nije uobičajeni događaj usmjeren na body.
Preglednik pokreće taj događaj kada se promijeni njegovo razumijevanje korisnikovih preferiranih jezika. U rukovatelju pročitaj navigator.languages za uređeni popis preferencija ili navigator.language za preferirani jezik. Promjena atributa lang ne znači da su se te preferencije promijenile, a sam događaj ne prevodi stranicu.
U JavaScriptu se isti rukovatelj može postaviti putem window.onlanguagechange. Nova dodjela zamjenjuje prethodni rukovatelj na tom mjestu; window.addEventListener('languagechange', handler) umjesto toga omogućuje registraciju neovisnih slušatelja. Sigurnosna pravila stranice mogu blokirati kod u atributima rukovatelja događaja.
Primjer namjerno šalje sintetički događaj objektu window kako rezultat ne bi ovisio o jezičnim postavkama uređaja. Provjerava pozivanje rukovatelja, ali ne mijenja preferencije niti testira prepoznaje li preglednik stvarnu promjenu preferencija.
Primjeri
<!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>Rezultat
languagechange received
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.