Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri