CKTIS / HTML
onunload — zpracování odpojení dokumentu
Atribut onunload prvku body nastavuje obslužnou funkci pro událost unload objektu Window, nikoli pro samotný prvek. Není spolehlivým místem k ukládání dat ani způsobem, jak zabránit opuštění stránky.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload je obsahový atribut obsluhy události unload. Na prvku body jeho hodnota obsahuje JavaScript, který se spouští jako obsluha na přidruženém objektu Window. Nejde o běžný globální atribut pro libovolné prvky HTML.
Jeho protějškem v JavaScriptu je window.onunload, kterému lze přiřadit funkci nebo null. Atribut body a tato vlastnost ovládají stejnou obsluhu: další přiřazení nahradí předchozí hodnotu a null ji odstraní. V kódu atributu zpřístupňuje událost parametr event.
unload souvisí s odpojováním dokumentu, ale nepředpokládejte, že nastane při každém opuštění stránky. Algoritmus standardu jej vynechá, pokud se dokument uchovává pro pozdější obnovení z historie. Nepoužívejte jej jako jediné místo pro ukládání důležitých dat a nespoléhejte na to, že se zde dokončí asynchronní práce. K pozorování životního cyklu zvažte podle účelu pagehide nebo visibilitychange.
Nezaměňujte onunload za onbeforeunload: událost unload nelze zrušit a return false nezastaví navigaci ani nezobrazí dotaz, zda chcete stránku opustit. Příklad záměrně vyšle syntetickou událost, aby ukázal vazbu atributu na Window, aniž by stránku zavřel; skutečné odpojení dokumentu neznázorňuje.
Příklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onunload demonstration</title>
<body onunload="document.getElementById('result').textContent = event.type">
<output id="result">pending</output>
<script>
window.dispatchEvent(new Event('unload'));
window.onunload = null;
</script>
</body>
</html>Výsledek
unload
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.