Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Zdarzenia `popstate` i `hashchange` obiektu `Window`

Użyj `popstate`, aby odczytać stan aktywowanego wpisu historii, a `hashchange`, aby wykryć zmianę fragmentu URL w tym samym dokumencie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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 to dwa odrębne zdarzenia interfejsu Window z platformy webowej, a nie elementy ECMAScript. Nasłuchuj ich za pomocą window.addEventListener(). Właściwości window.onpopstate i window.onhashchange to alternatywa: nowe przypisanie zastępuje poprzednią funkcję obsługi przypisaną do tej samej właściwości.

popstate sygnalizuje aktywację innego wpisu historii sesji, na przykład podczas przechodzenia Wstecz lub Dalej w obrębie tego samego dokumentu. PopStateEvent.state zawiera odtworzoną wartość zapisaną dla wpisu docelowego lub null, jeśli nie zapisano stanu. Nawigacja do fragmentu w tym samym dokumencie również może wywołać popstate. Nie używaj tego zdarzenia do inicjalizacji widoku: przeglądarka może go nie wysłać przed interakcją użytkownika ze stroną.

hashchange sygnalizuje zmianę fragmentu URL w tym samym dokumencie, na przykład po kliknięciu odnośnika do #details lub ustawieniu location.hash na nowy fragment. HashChangeEvent.oldURL i HashChangeEvent.newURL to pełne adresy URL, nie same fragmenty. Gdy ta sama operacja wywołuje oba zdarzenia, najpierw występuje popstate.

history.pushState() dodaje wpis, a history.replaceState() modyfikuje bieżący. Żadne z tych wywołań samo nie wywołuje żadnego z dwóch zdarzeń, nawet gdy zmienia fragment. Wyrenderuj widok na początku i zaktualizuj go bezpośrednio po udanej zmianie historii w kodzie. Jeśli nasłuchujesz obu zdarzeń, nie wykonuj tej samej aktualizacji dwukrotnie.

Przykłady

<!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>

Wynik

after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overview

Zapisz przykład jako `index.html`, udostępnij go przez HTTP(S) i otwórz w osobnej karcie testowej: przykład zmienia wpisy historii. Otwórz konsolę narzędzi deweloperskich i kliknij na stronie przycisk „Run history demo”. Dwa zapisy historii nie wywołają zdarzeń; po asynchronicznym powrocie konsola pokaże stan `overview` i zmianę fragmentu.

Powiązane lekcje

  • JavaScript · Lekcja 36 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 37 · Średniozaawansowany · Wersja: 3

Źródła