CKTIS / JavaScript
Události `Window`: `popstate` a `hashchange`
Pomocí `popstate` přečteš stav aktivované položky historie a pomocí `hashchange` zjistíš změnu fragmentu URL v rámci stejného dokumentu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 a hashchange jsou dvě různé události rozhraní Window. Patří do webové platformy, nikoli do ECMAScriptu. Posluchače zaregistruj pomocí window.addEventListener(). Alternativou jsou vlastnosti window.onpopstate a window.onhashchange: nové přiřazení nahradí obslužnou funkci dříve přiřazenou k téže vlastnosti.
popstate oznamuje aktivaci jiné položky historie relace, například při přechodu zpět nebo vpřed v rámci téhož dokumentu. PopStateEvent.state obsahuje obnovenou hodnotu uloženou u cílové položky, nebo null, pokud se žádný stav neuložil. Událost popstate může vyvolat také přechod na fragment v témže dokumentu. Nespoléhej na ni při prvním vykreslení: prohlížeč ji nemusí vyvolat, dokud uživatel se stránkou neprovede nějakou interakci.
hashchange oznamuje změnu fragmentu URL v témže dokumentu, například po kliknutí na odkaz na #details nebo po nastavení location.hash na nový fragment. HashChangeEvent.oldURL a HashChangeEvent.newURL obsahují celé adresy URL, nikoli jen fragmenty. Pokud stejná operace vyvolá obě události, popstate proběhne jako první.
history.pushState() přidá položku, zatímco history.replaceState() upraví aktuální položku. Ani jedno volání samo nevyvolá žádnou z těchto událostí, a to ani při změně fragmentu. Zobrazení inicializuj přímo a po úspěšné změně historie ve svém kódu ho rovnou aktualizuj. Posloucháš-li obě události, neprováděj stejnou aktualizaci dvakrát.
Příklady
<!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>Výsledek
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewUlož příklad jako `index.html`, zpřístupni ho přes HTTP(S) a otevři ho na samostatné testovací kartě: příklad mění položky historie. Otevři vývojářskou konzoli a na stránce klikni na „Run history demo“. Dva zápisy do historie nevyvolají žádnou z obou událostí; po asynchronním návratu konzole vypíše stav `overview` a změnu fragmentu.
Související lekce
- JavaScript · Lekce 36 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 37 · Středně pokročilá · Verze: 3