CKTIS / HTML
onunload — obrada napuštanja dokumenta
Atribut onunload elementa body postavlja rukovatelj za događaj unload objekta Window, a ne rukovatelj usmjeren na sam element. Nije pouzdano mjesto za spremanje podataka ni način da se spriječi napuštanje stranice.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload je sadržajni atribut rukovatelja događajem unload. Na elementu body njegova vrijednost sadrži JavaScript koji se izvršava kao rukovatelj na povezanom objektu Window. Nije riječ o uobičajenom globalnom atributu za proizvoljne HTML elemente.
Njegov je JavaScript ekvivalent window.onunload, kojemu se može dodijeliti funkcija ili null. Atribut body i to svojstvo upravljaju istim rukovateljem: sljedeća dodjela zamjenjuje prethodnu vrijednost, a null ga uklanja. U kodu atributa događaj je dostupan putem parametra event.
unload se odnosi na napuštanje dokumenta, ali nemojte pretpostaviti da se događa svaki put kad se napusti stranica. Algoritam standarda preskače ga kada se dokument zadržava radi kasnijeg vraćanja iz povijesti. Nemojte ga koristiti kao jedino mjesto za spremanje važnih podataka niti se oslanjati na to da će se ondje dovršiti asinkroni rad. Za praćenje životnog ciklusa, ovisno o svrsi, razmotrite pagehide ili visibilitychange.
Nemojte miješati onunload i onbeforeunload: unload se ne može otkazati, a return false ne zaustavlja navigaciju niti prikazuje upit o napuštanju stranice. Primjer namjerno šalje sintetički događaj kako bi pokazao vezu atributa s objektom Window, bez zatvaranja stranice; ne oponaša stvarno napuštanje dokumenta.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.