CKTIS / HTML
onpageshow — het weergeven van een pagina afhandelen
Het onpageshow-attribuut op body koppelt JavaScript-code aan de pageshow-gebeurtenis van het Window-object. Het handelt zowel het weergeven van een nieuw geladen document af als het opnieuw weergeven van een bewaard document tijdens navigatie door de geschiedenis.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onpageshow="JavaScript code">onpageshow is een gebeurtenisafhandelingsattribuut dat op het element body wordt geschreven. De waarde is JavaScript-code, geen booleaanse waarde. Ondanks de plek in de markup handelt het de pageshow-gebeurtenis van het Window-object af, niet een gewone gebeurtenis van het element body.
Bij een nieuw geladen document treedt pageshow op na load. Het treedt ook op wanneer een bewaard document opnieuw wordt weergegeven tijdens navigatie door de geschiedenis. De parameter event is een PageTransitionEvent: event.persisted is false voor een nieuw geladen document en true voor een hergebruikt document. Alleen de knop Vorige gebruiken garandeert geen true, omdat de browser het document opnieuw kan laden.
Het attribuut op body en de eigenschap window.onpageshow verwijzen naar dezelfde gebeurtenisafhandelaar; behandel ze niet als twee onafhankelijke plekken voor functies. Een alternatief is window.addEventListener('pageshow', handler), waarmee onafhankelijke afhandelaars kunnen worden toegevoegd. Een Content Security Policy kan code in attributen blokkeren.
Het voorbeeld vervangt de tekst van de alinea door informatie over event.persisted. Als het bestand als nieuw document wordt geopend, is de verwachte tekst pageshow: persisted=false. Als hetzelfde document uit de back/forward-cache wordt hersteld, is de verwachte tekst pageshow: persisted=true; herstel is niet gegarandeerd.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onpageshow example</title>
</head>
<body onpageshow="document.getElementById('status').textContent = 'pageshow: persisted=' + event.persisted">
<p id="status">Waiting for pageshow</p>
</body>
</html>Resultaat
pageshow: persisted=false
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.