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