Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onlanguagechange — obravnavanje sprememb prednostnih jezikov

Atribut onlanguagechange na body nastavi obravnavo dogodka languagechange za objekt Window. Dogodek označuje spremembo uporabnikovih prednostnih jezikov, kot jih prepozna brskalnik, ne pa spremembe atributa lang dokumenta.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onlanguagechange="JavaScript statements">

onlanguagechange je vsebinski atribut za obravnavo dogodka, ki se uporablja na body. Njegova vrednost vsebuje JavaScript, ki se izvede ob dogodku languagechange objekta Window; to ni običajen dogodek, usmerjen na body.

Brskalnik sproži ta dogodek, ko se spremeni njegovo razumevanje uporabnikovih prednostnih jezikov. V obravnavi preberi navigator.languages za urejen seznam prednosti ali navigator.language za prednostni jezik. Sprememba atributa lang ne pomeni, da so se te prednosti spremenile, sam dogodek pa strani ne prevede.

V JavaScriptu lahko isto obravnavo nastaviš prek window.onlanguagechange. Nova dodelitev zamenja prejšnjo obravnavo na tem mestu; window.addEventListener('languagechange', handler) pa omogoča registracijo neodvisnih poslušalcev. Varnostna politika strani lahko blokira kodo v atributih za obravnavo dogodkov.

Primer namerno sproži sintetični dogodek na window, da rezultat ni odvisen od jezikovnih nastavitev naprave. Preveri, ali se obravnava izvede, vendar ne spremeni prednosti in ne preizkusi, ali brskalnik zazna dejansko spremembo prednosti.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri