CKTIS / HTML
onpopstate — wijzigingen in het actieve geschiedenisitem afhandelen
Het onpopstate-attribuut van body stelt de popstate-eventhandler van het Window-object in. Een pagina kan zo reageren op navigatie door de sessiegeschiedenis, bijvoorbeeld met Vorige en Volgende, en de status van het bestemmingsitem lezen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onpopstate="handleState(event)">
window.onpopstate = handleState;onpopstate is een eventhandlerattribuut dat beschikbaar is op body, niet een globaal attribuut voor willekeurige elementen. Het biedt de popstate-handler van het Window-object. Met window.onpopstate = handleState stel je diezelfde handler in; er ontstaat geen tweede, onafhankelijke listener.
popstate hoort bij navigatie door de sessiegeschiedenis, bijvoorbeeld via Vorige, Volgende of history.back(). Alleen history.pushState() of history.replaceState() aanroepen activeert het event niet. In de handler bevat event.state de herstelde status van het bestemmingsitem. Deze kan null zijn; houd daar rekening mee voordat je de eigenschappen ervan benadert.
Een latere toewijzing aan window.onpopstate vervangt de vorige handler; door null toe te wijzen verwijder je deze. Gebruik window.addEventListener('popstate', handleState) voor onafhankelijke handlers. Beschouw popstate niet als een manier om navigatie te annuleren.
Het voorbeeld verstuurt bewust een synthetisch PopStateEvent met een vaste status. Het controleert de koppeling van het attribuut met Window, maar wijzigt de geschiedenis niet en test geen echte navigatie door de geschiedenis. De CSP van een toepassing kan inline-handlerattributen blokkeren; registreer de handler in dat geval in een toegestaan script.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onpopstate demo</title>
</head>
<body onpopstate="document.getElementById('result').textContent = 'step=' + event.state.step">
<button id="test" type="button">Test</button>
<output id="result">Ready</output>
<script>
document.getElementById('test').addEventListener('click', () => {
window.dispatchEvent(new PopStateEvent('popstate', {
state: { step: 1 }
}));
});
</script>
</body>
</html>Resultaat
step=1
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.