KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onpagehide — het verlaten van een pagina afhandelen

Het onpagehide-attribuut op body registreert een handler voor het pagehide-event van het Window-object. Bij een door de browser gegenereerd event geeft de waarde true van event.persisted aan dat de browser het document wil bewaren voor mogelijk hergebruik, niet dat het daadwerkelijk wordt bewaard.

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

Syntax

<body onpagehide="JavaScript statements">

onpagehide is een event-handlerattribuut voor pagehide. Als het op body staat, handelt het het event op Window af, niet een event dat beperkt is tot dat element. Het is geen globaal attribuut dat op willekeurige elementen beschikbaar is. De standaard biedt het ook aan op het verouderde element frameset. De waarde bevat JavaScript-instructies; het eventobject is beschikbaar als event.

Het event pagehide gaat over het verlaten van een pagina, niet over alleen het wisselen van tabblad. Bij een door de browser gegenereerd event heeft de eigenschap persisted van het object PageTransitionEvent de waarde false als het document definitief wordt verlaten, en true als de browser het document wil bewaren voor mogelijk hergebruik, bijvoorbeeld in de back/forward-cache (bfcache). De waarde true garandeert niet dat het document daadwerkelijk wordt bewaard of later wordt hersteld.

De JavaScript-tegenhanger is window.onpagehide = handler; deze toewijzing vervangt de vorige handler in die eigenschap. Met window.addEventListener('pagehide', handler) kun je onafhankelijke listeners registreren. Het voorbeeld verstuurt een synthetisch event voor een reproduceerbare uitvoer: het verlaat de pagina niet en plaatst die ook niet in de bfcache.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
  <output id="result">Waiting</output>
  <script>
    window.dispatchEvent(new PageTransitionEvent('pagehide', {
      persisted: true
    }));
  </script>
</body>
</html>

Resultaat

pagehide: persisted=true

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