CKTIS / HTML
onlanguagechange — zpracování změn preferovaných jazyků
Atribut onlanguagechange na body nastavuje obslužnou funkci objektu Window pro událost languagechange. Událost oznamuje změnu preferovaných jazyků uživatele podle toho, jak je rozpoznává prohlížeč, nikoli změnu atributu lang dokumentu.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onlanguagechange="JavaScript statements">onlanguagechange je obsahový atribut obslužné funkce události používaný na body. Jeho hodnota obsahuje JavaScript, který se spustí při události languagechange objektu Window; nejde o běžnou událost cílenou na body.
Prohlížeč tuto událost vyvolá, když se změní jeho chápání preferovaných jazyků uživatele. V obslužné funkci čti navigator.languages, pokud potřebuješ seřazené preference, nebo navigator.language pro zjištění preferovaného jazyka. Změna atributu lang neznamená, že se změnily tyto preference, a samotná událost stránku nepřekládá.
V JavaScriptu lze stejnou obslužnou funkci nastavit pomocí window.onlanguagechange. Nové přiřazení nahradí předchozí funkci v tomto slotu; window.addEventListener('languagechange', handler) místo toho umožňuje registrovat nezávislé posluchače. Bezpečnostní politika stránky může blokovat kód v atributech obslužných funkcí událostí.
Příklad záměrně odešle syntetickou událost na window, aby výsledek nezávisel na jazykovém nastavení zařízení. Ověří zavolání obslužné funkce, ale nemění preference ani netestuje, zda prohlížeč rozpozná skutečnou změnu preferencí.
Pří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ýsledek
languagechange received
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.