Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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 -> #overview

Spremi 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

Izvori