Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onlanguagechange — spracovanie zmien preferovaných jazykov

Atribút onlanguagechange na body nastavuje obslužnú funkciu objektu Window pre udalosť languagechange. Udalosť signalizuje zmenu preferovaných jazykov používateľa podľa toho, ako ich rozpoznáva prehliadač, nie zmenu atribútu lang dokumentu.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onlanguagechange="JavaScript statements">

onlanguagechange je obsahový atribút obslužnej funkcie udalosti používaný na body. Jeho hodnota obsahuje JavaScript, ktorý sa vykoná pri udalosti languagechange objektu Window; nejde o bežnú udalosť zacielenú na body.

Prehliadač túto udalosť vyvolá, keď sa zmení jeho chápanie preferovaných jazykov používateľa. V obslužnej funkcii čítaj navigator.languages, ak potrebuješ zoradené preferencie, alebo navigator.language na zistenie preferovaného jazyka. Zmena atribútu lang neznamená, že sa zmenili tieto preferencie, a samotná udalosť stránku neprekladá.

V JavaScripte možno rovnakú obslužnú funkciu nastaviť pomocou window.onlanguagechange. Nové priradenie nahradí predchádzajúcu funkciu v tomto slote; window.addEventListener('languagechange', handler) namiesto toho umožňuje registrovať nezávislých poslucháčov. Bezpečnostná politika stránky môže blokovať kód v atribútoch obslužných funkcií udalostí.

Príklad zámerne odošle syntetickú udalosť na window, aby výsledok nezávisel od jazykových nastavení zariadenia. Overí zavolanie obslužnej funkcie, ale nemení preferencie ani netestuje, či prehliadač rozpozná skutočnú zmenu preferencií.

Príklady

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

Výsledok

languagechange received

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje