CKTIS / HTML
onunload — obsluha udalosti pri uvoľňovaní dokumentu
Atribút onunload prvku body nastavuje obslužnú funkciu pre udalosť unload objektu Window, nie pre samotný prvok. Nie je spoľahlivým miestom na ukladanie údajov ani spôsobom, ako zabrániť opusteniu stránky.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload je obsahový atribút obsluhy udalosti unload. Na prvku body jeho hodnota obsahuje JavaScript, ktorý sa spúšťa ako obsluha na priradenom objekte Window. Nie je to bežný globálny atribút pre ľubovoľné prvky HTML.
Jeho náprotivkom v JavaScripte je window.onunload, ktorému možno priradiť funkciu alebo null. Atribút body a táto vlastnosť ovládajú tú istú obsluhu: ďalšie priradenie nahradí predchádzajúcu hodnotu a null ju odstráni. V kóde atribútu sprístupňuje udalosť parameter event.
Udalosť unload súvisí s uvoľňovaním dokumentu, no nepredpokladajte, že nastane pri každom opustení stránky. Algoritmus štandardu ju vynechá, keď sa dokument uchováva na neskoršie obnovenie z histórie. Nepoužívajte ju ako jediné miesto na ukladanie dôležitých údajov a nespoliehajte sa, že sa tam dokončí asynchrónna práca. Na sledovanie životného cyklu zvážte podľa účelu pagehide alebo visibilitychange.
Nezamieňajte onunload s onbeforeunload: udalosť unload nemožno zrušiť a return false nezastaví navigáciu ani nezobrazí otázku, či chcete stránku opustiť. Príklad zámerne vyšle syntetickú udalosť, aby ukázal prepojenie atribútu s Window bez zatvorenia stránky; skutočné uvoľnenie dokumentu nesimuluje.
Prí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ýsledok
unload
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.