CKTIS / HTML
onunload — obravnavanje odlaganja dokumenta
Atribut onunload elementa body nastavi obravnavo dogodka unload objekta Window, ne pa obravnave, ki bi ciljala sam element. Ni zanesljivo mesto za shranjevanje podatkov in tudi ne način, kako preprečiti zapustitev strani.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload je vsebinski atribut za obravnavo dogodka unload. Na elementu body njegova vrednost vsebuje JavaScript, ki se izvede kot obravnavalnik na povezanem objektu Window. Ne gre za običajen globalni atribut za poljubne elemente HTML.
Njegov ustreznik v JavaScriptu je window.onunload, ki sprejme funkcijo ali null. Atribut body in ta lastnost upravljata isti obravnavalnik: naslednja dodelitev nadomesti prejšnjo vrednost, null pa ga odstrani. V kodi atributa dogodek zagotavlja parameter event.
unload je povezan z odlaganjem dokumenta, vendar ne predpostavljajte, da se sproži ob vsakem zapuščanju strani. Algoritem standarda ga preskoči, kadar se dokument ohrani za poznejšo obnovitev iz zgodovine. Ne uporabljajte ga kot edino mesto za shranjevanje pomembnih podatkov in ne zanašajte se na to, da se bo tam končalo asinhrono delo. Za opazovanje življenjskega cikla glede na namen uporabite pagehide ali visibilitychange.
Ne zamenjujte onunload z onbeforeunload: dogodka unload ni mogoče preklicati, return false pa ne ustavi navigacije in ne prikaže vprašanja o zapustitvi strani. Primer namerno sproži sintetični dogodek, da pokaže povezavo atributa z Window, ne da bi zaprl stran; dejanskega odlaganja dokumenta ne ponazarja.
Primeri
<!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>Rezultat
unload
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.