KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onunload — het ontladen van een document afhandelen

Het onunload-attribuut van het body-element stelt een handler in voor het unload-event van het Window-object, niet voor het element zelf. Het is geen betrouwbare plek om gegevens op te slaan en ook geen manier om te voorkomen dat iemand een pagina verlaat.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;

onunload is een event-handlercontentattribuut voor unload. Op het body-element bevat de waarde JavaScript dat als handler op het bijbehorende Window-object wordt uitgevoerd. Het is geen gewoon globaal attribuut voor willekeurige HTML-elementen.

De JavaScript-tegenhanger is window.onunload, waaraan een functie of null kan worden toegewezen. Het body-attribuut en deze eigenschap sturen dezelfde handler aan: een volgende toewijzing vervangt de vorige waarde en null verwijdert de handler. In de code van het attribuut geeft de parameter event toegang tot het event.

unload heeft betrekking op het ontladen van een document, maar ga er niet van uit dat het wordt geactiveerd telkens wanneer een pagina wordt verlaten. Het algoritme van de standaard slaat het over wanneer het document wordt bewaard om later vanuit de geschiedenis te worden hersteld. Gebruik het niet als enige plek om belangrijke gegevens op te slaan en vertrouw er niet op dat asynchroon werk daar wordt afgerond. Overweeg voor het volgen van de levenscyclus pagehide of visibilitychange, afhankelijk van je doel.

Verwar onunload niet met onbeforeunload: unload kan niet worden geannuleerd en return false stopt de navigatie niet en toont geen vraag om te bevestigen dat je de pagina wilt verlaten. Het voorbeeld verstuurt bewust een synthetisch event om de koppeling van het attribuut aan Window te laten zien zonder de pagina te sluiten; het bootst het daadwerkelijke ontladen van een document niet na.

Voorbeelden

<!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>

Resultaat

unload

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen