CKTIS / HTML
onunload — obsługa zdarzenia opuszczania dokumentu
Atrybut onunload elementu body ustawia procedurę obsługi zdarzenia unload obiektu Window, a nie samego elementu. Nie jest niezawodnym miejscem zapisywania danych ani sposobem blokowania opuszczenia strony.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload jest atrybutem obsługi zdarzenia unload. Na elemencie body jego wartość zawiera kod JavaScript wykonywany jako procedura obsługi na powiązanym obiekcie Window. Nie jest to zwykły globalny atrybut dowolnego elementu HTML.
W JavaScript odpowiada mu właściwość window.onunload, przyjmująca funkcję lub null. Atrybut elementu body i ta właściwość sterują tą samą procedurą obsługi: kolejne przypisanie zastępuje poprzednią wartość, a null ją usuwa. W kodzie atrybutu parametr event udostępnia zdarzenie.
unload dotyczy wyładowywania dokumentu, ale nie należy zakładać, że wystąpi przy każdym opuszczeniu strony. Algorytm standardu pomija je, gdy dokument jest zachowywany do późniejszego przywrócenia z historii. Nie opieraj na nim jedynego zapisu ważnych danych ani zakończenia pracy asynchronicznej. Do obserwacji cyklu życia rozważ pagehide lub visibilitychange, zależnie od celu.
Nie myl onunload z onbeforeunload: unload nie można anulować, a return false nie zatrzyma nawigacji ani nie wyświetli pytania o opuszczenie strony. Przykład celowo wysyła syntetyczne zdarzenie, aby pokazać powiązanie atrybutu z Window bez zamykania strony; nie odtwarza rzeczywistego wyładowania dokumentu.
Przykłady
<!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>Wynik
unload
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.