Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori