CKTIS / JavaScript
`Window`-gebeurtenissen: `popstate` en `hashchange`
Lees met `popstate` de status van het geactiveerde geschiedenisitem en detecteer met `hashchange` een wijziging van het URL-fragment binnen hetzelfde document.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
window.addEventListener("popstate", handlePopState); // PopStateEvent: event.state
window.addEventListener("hashchange", handleHashChange); // HashChangeEvent: event.oldURL, event.newURL
// Alternative: assign one handler per property.
window.onpopstate = handlePopState;
window.onhashchange = handleHashChange;popstate en hashchange zijn twee verschillende gebeurtenissen op Window. Ze zijn onderdeel van het webplatform, niet van ECMAScript. Luister ernaar met window.addEventListener(). Je kunt ook window.onpopstate en window.onhashchange gebruiken: als je een nieuwe handler aan een eigenschap toewijst, vervang je de handler die eerder aan die eigenschap was toegewezen.
popstate geeft aan dat een ander item in de sessiegeschiedenis actief wordt, bijvoorbeeld als je binnen hetzelfde document terug- of vooruitgaat. PopStateEvent.state bevat de herstelde waarde van het doelitem, of null als er geen status was opgeslagen. Ook navigatie naar een fragment binnen hetzelfde document kan popstate genereren. Vertrouw er niet op voor de eerste weergave: de browser kan de gebeurtenis tegenhouden totdat de gebruiker interactie heeft gehad met de pagina.
hashchange geeft aan dat het URL-fragment binnen hetzelfde document is gewijzigd, bijvoorbeeld wanneer je een link naar #details volgt of location.hash op een nieuw fragment instelt. HashChangeEvent.oldURL en HashChangeEvent.newURL zijn volledige URL’s, niet alleen fragmenten. Als dezelfde handeling beide gebeurtenissen genereert, komt popstate eerst.
history.pushState() voegt een item toe, terwijl history.replaceState() het huidige item bijwerkt. Geen van beide aanroepen genereert zelf een van deze gebeurtenissen, ook niet bij een gewijzigd fragment. Toon de eerste weergave zelf en werk die direct bij nadat je code de geschiedenis met succes heeft aangepast. Als je naar beide gebeurtenissen luistert, pas dezelfde wijziging dan niet twee keer toe.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>History events demo</title>
</head>
<body>
<button id="run-history-demo" type="button">Run history demo</button>
<script>
(() => {
const button = document.getElementById("run-history-demo");
button.addEventListener("click", () => {
button.remove();
window.addEventListener("popstate", (event) => {
console.log(`popstate: ${JSON.stringify(event.state)}`);
}, { once: true });
window.addEventListener("hashchange", (event) => {
const from = new URL(event.oldURL).hash;
const to = new URL(event.newURL).hash;
console.log(`hashchange: ${from} -> ${to}`);
}, { once: true });
history.replaceState({ view: "overview" }, "", "#overview");
history.pushState({ view: "details" }, "", "#details");
console.log(`after writes: ${location.hash}`);
history.back();
}, { once: true });
})();
</script>
</body>
</html>Resultaat
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewSla het voorbeeld op als `index.html`, bied het aan via HTTP(S) en open het in een apart testtabblad: het voorbeeld wijzigt geschiedenisitems. Open de ontwikkelaarsconsole en klik op de pagina op ‘Run history demo’. De twee wijzigingen in de geschiedenis genereren geen van beide gebeurtenissen; na de asynchrone terugkeer zie je in de console de status `overview` en de fragmentwijziging.
Gerelateerde lessen
- JavaScript · Les 36 · Gemiddeld · Versie: 3
- JavaScript · Les 37 · Gemiddeld · Versie: 3