CKTIS / HTML
ononline — obsluha události online
Atribut ononline u prvku body určuje kód JavaScriptu, který obsluhuje událost online objektu Window. Signalizuje změnu v posouzení dostupnosti sítě prohlížečem, nepotvrzuje však dosažitelnost konkrétního serveru.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body ononline="JavaScript statements">ononline je obsahový atribut obsluhy události online. Je-li zapsán na body, nastavuje obsluhu na objektu Window, nikoli obsluhu běžné události směřované na body. Hodnotou atributu je kód JavaScriptu; dostupný parametr event představuje událost.
Prohlížeč vyvolá online, když se navigator.onLine změní z false na true. Neznamená to, že je dosažitelný konkrétní server ani že síťový požadavek uspěje. Samotná registrace obsluhy ji pro počáteční stav připojení nevyvolá.
Odpovídající vlastností JavaScriptu je window.ononline. Přiřazení hodnoty nahradí předchozí obsluhu této vlastnosti. Alternativou je window.addEventListener('online', handler), který umožňuje registrovat nezávislé funkce posluchačů. Do kódu atributu nevkládejte nedůvěryhodná data.
Příklad záměrně odešle syntetickou událost objektu window, aby ověřil propojení atributu bez změny připojení. Očekávaný text odstavce je online. Tento test nemění navigator.onLine a nedokazuje přístup k Internetu. Content Security Policy může blokovat obsluhy zapsané přímo v atributech.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ononline demo</title>
</head>
<body ononline="document.getElementById('status').textContent = event.type">
<p id="status">waiting</p>
<script>
window.dispatchEvent(new Event('online'));
</script>
</body>
</html>Výsledek
online
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.