CKTIS / HTML
onunload — gestire lo scaricamento di un documento
L’attributo onunload dell’elemento body imposta un gestore per l’evento unload dell’oggetto Window, non un gestore destinato all’elemento stesso. Non è né un luogo affidabile per salvare dati né un modo per impedire di lasciare una pagina.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload è un attributo di contenuto gestore di eventi per unload. Sull’elemento body, il suo valore contiene JavaScript eseguito come gestore sull’oggetto Window associato. Non è un normale attributo globale per qualsiasi elemento HTML.
Il suo corrispettivo JavaScript è window.onunload, a cui si può assegnare una funzione o null. L’attributo body e questa proprietà controllano lo stesso gestore: un’assegnazione successiva sostituisce il valore precedente e null lo rimuove. Nel codice dell’attributo, il parametro event fornisce l’evento.
unload riguarda lo scaricamento di un documento, ma non dare per scontato che si verifichi ogni volta che si lascia una pagina. L’algoritmo dello standard lo salta quando il documento viene conservato per essere ripristinato in seguito dalla cronologia. Non usarlo come unico luogo in cui salvare dati importanti e non fare affidamento sul completamento di attività asincrone in quel momento. Per osservare il ciclo di vita, valuta pagehide o visibilitychange, a seconda dello scopo.
Non confondere onunload con onbeforeunload: unload non è annullabile e return false non interrompe la navigazione né mostra una richiesta di conferma prima di lasciare la pagina. L’esempio invia deliberatamente un evento sintetico per mostrare il collegamento dell’attributo con Window senza chiudere la pagina; non riproduce lo scaricamento effettivo del documento.
Esempi
<!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>Risultato
unload
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.