CKTIS / JavaScript
Događaji objekta `Window`: `popstate` i `hashchange`
Događajem `popstate` očitaj stanje aktiviranog unosa povijesti, a događajem `hashchange` otkrij promjenu fragmenta URL-a unutar istog dokumenta.
Verzija: 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 i hashchange dva su različita događaja sučelja Window. Definira ih web-platforma, a ne ECMAScript. Slušatelje registriraj pomoću window.addEventListener(). Možeš upotrijebiti i svojstva window.onpopstate i window.onhashchange: nova dodjela zamjenjuje funkciju za obradu događaja prethodno dodijeljenu istom svojstvu.
popstate označava aktivaciju drugog unosa u povijesti sesije, primjerice pri kretanju natrag ili naprijed unutar istog dokumenta. PopStateEvent.state sadrži obnovljenu vrijednost ciljnog unosa ili null ako stanje nije spremljeno. I navigacija na fragment unutar istog dokumenta može pokrenuti popstate. Nemoj se oslanjati na taj događaj za početni prikaz: preglednik ga možda neće pokrenuti dok korisnik ne stupi u interakciju sa stranicom.
hashchange označava promjenu fragmenta URL-a u istom dokumentu, primjerice nakon klika na poveznicu na #details ili postavljanja location.hash na novi fragment. HashChangeEvent.oldURL i HashChangeEvent.newURL sadrže pune URL-ove, ne samo fragmente. Ako ista radnja pokrene oba događaja, popstate dolazi prvi.
history.pushState() dodaje unos, a history.replaceState() ažurira trenutačni unos. Nijedan poziv sam po sebi ne pokreće nijedan od dvaju događaja, čak ni ako promijeni fragment. Sam prikaži početni prikaz i ažuriraj ga izravno nakon uspješne promjene povijesti u svojem kodu. Ako slušaš oba događaja, nemoj dvaput primijeniti isto ažuriranje.
Primjeri
<!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 -> #overviewSpremi primjer kao `index.html`, posluži ga preko HTTP(S)-a i otvori ga u zasebnoj kartici za testiranje: primjer mijenja unose povijesti. Otvori razvojnu konzolu i na stranici klikni „Run history demo”. Dva upisa u povijest ne pokreću nijedan od događaja; pri asinkronom povratku ispisuju se stanje `overview` i promjena fragmenta.
Povezane lekcije
- JavaScript · Lekcija 36 · Srednje · Verzija: 3
- JavaScript · Lekcija 37 · Srednje · Verzija: 3