CKTIS / JavaScript
Udalosti `Window`: `popstate` a `hashchange`
Pomocou `popstate` zistíš stav aktivovanej položky histórie a pomocou `hashchange` rozpoznáš zmenu fragmentu URL v tom istom dokumente.
Verzia: 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 a hashchange sú dve odlišné udalosti rozhrania Window, ktoré definuje webová platforma, nie ECMAScript. Počúvaj ich pomocou window.addEventListener(). Alternatívou sú vlastnosti window.onpopstate a window.onhashchange: priradenie novej obslužnej funkcie nahradí funkciu predtým priradenú k tej istej vlastnosti.
popstate signalizuje aktiváciu inej položky histórie relácie, napríklad pri prechode späť alebo dopredu v rámci toho istého dokumentu. PopStateEvent.state obsahuje obnovenú hodnotu uloženú pre cieľovú položku alebo null, ak sa žiadny stav neuložil. Udalosť popstate môže vyvolať aj prechod na fragment v tom istom dokumente. Pri inicializácii zobrazenia sa na ňu nespoliehaj: prehliadač ju nemusí vyvolať, kým používateľ so stránkou neinteraguje.
hashchange signalizuje zmenu fragmentu URL v tom istom dokumente, napríklad po kliknutí na odkaz na #details alebo nastavení location.hash na nový fragment. HashChangeEvent.oldURL a HashChangeEvent.newURL obsahujú celé adresy URL, nielen fragmenty. Ak tá istá operácia vyvolá obe udalosti, popstate nastane ako prvá.
history.pushState() pridá položku, kým history.replaceState() aktualizuje aktuálnu položku. Ani jedno volanie samo nevyvolá žiadnu z týchto udalostí, ani keď zmení fragment. Zobrazenie inicializuj priamo a po úspešnej zmene histórie vo svojom kóde ho hneď aktualizuj. Ak počúvaš obe udalosti, nerob tú istú aktualizáciu dvakrát.
Príklady
<!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>Výsledok
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewUlož príklad ako `index.html`, sprístupni ho cez HTTP(S) a otvor ho na samostatnej testovacej karte: príklad mení položky histórie. Otvor vývojársku konzolu a na stránke klikni na „Run history demo“. Dva zápisy do histórie nevyvolajú žiadnu z oboch udalostí; po asynchrónnom návrate sa vypíše stav `overview` aj zmena fragmentu.
Súvisiace lekcie
- JavaScript · Lekcia 36 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 37 · Stredne pokročilá · Verzia: 3