CKTIS / JavaScript
Dogodka `Window`: `popstate` in `hashchange`
Z dogodkom `popstate` prebereš stanje aktiviranega vnosa v zgodovini, z dogodkom `hashchange` pa zaznaš spremembo fragmenta URL-ja v istem dokumentu.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 in hashchange sta dva različna dogodka vmesnika Window. Določa ju spletna platforma, ne ECMAScript. Poslušalce registriraj z window.addEventListener(). Uporabiš lahko tudi lastnosti window.onpopstate in window.onhashchange: nova dodelitev nadomesti prej dodeljeno funkcijo za obravnavo dogodka na isti lastnosti.
popstate sporoči, da je postal aktiven drug vnos v zgodovini seje, na primer ob premiku nazaj ali naprej znotraj istega dokumenta. PopStateEvent.state vsebuje obnovljeno vrednost ciljnega vnosa ali null, če stanje ni bilo shranjeno. Dogodek popstate lahko sproži tudi premik na fragment v istem dokumentu. Pri začetnem prikazu se nanj ne zanašaj: brskalnik ga morda ne sproži, dokler uporabnik ne izvede kakšnega dejanja na strani.
hashchange sporoči spremembo fragmenta URL-ja v istem dokumentu, na primer po kliku povezave na #details ali nastavitvi location.hash na nov fragment. HashChangeEvent.oldURL in HashChangeEvent.newURL vsebujeta celotna URL-ja, ne le fragmentov. Če isto dejanje sproži oba dogodka, je popstate prvi.
history.pushState() doda vnos, history.replaceState() pa posodobi trenutni vnos. Noben od teh klicev sam ne sproži nobenega od obeh dogodkov, tudi če spremeni fragment. Začetni pogled prikaži sam in ga posodobi neposredno po uspešni spremembi zgodovine v svoji kodi. Če poslušaš oba dogodka, iste posodobitve ne izvedi dvakrat.
Primeri
<!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>Rezultat
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewShrani primer kot `index.html`, omogoči dostop prek HTTP(S) in ga odpri v ločenem preizkusnem zavihku: primer spremeni vnose v zgodovini. Odpri razvijalsko konzolo in na strani klikni »Run history demo«. Oba zapisa v zgodovino ne sprožita nobenega od dogodkov; po asinhroni vrnitvi se izpišeta stanje `overview` in sprememba fragmenta.
Povezane lekcije
- JavaScript · Lekcija 36 · Srednja · Različica: 3
- JavaScript · Lekcija 37 · Srednja · Različica: 3