CKTIS / JavaScript
Събития на `Window`: `popstate` и `hashchange`
Използвай `popstate`, за да прочетеш състоянието на активирания запис в историята, и `hashchange`, за да откриеш промяна на URL фрагмента в същия документ.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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 и hashchange са две различни събития на Window, определени от уеб платформата, а не от ECMAScript. Регистрирай обработчици с window.addEventListener(). Можеш да използваш и свойствата window.onpopstate и window.onhashchange: присвояването на нов обработчик заменя предишния, присвоен на същото свойство.
popstate сигнализира, че е активиран друг запис в историята на сесията, например при връщане назад или придвижване напред в рамките на същия документ. PopStateEvent.state съдържа възстановената стойност на целевия запис или null, ако не е запазено състояние. Преминаването към фрагмент в същия документ също може да предизвика popstate. Не разчитай на това събитие за първоначалното показване на изгледа: браузърът може да не го изпрати, преди потребителят да взаимодейства със страницата.
hashchange сигнализира за промяна на URL фрагмента в същия документ, например при следване на връзка към #details или задаване на нов фрагмент чрез location.hash. HashChangeEvent.oldURL и HashChangeEvent.newURL са пълни URL адреси, а не само фрагменти. Ако една и съща операция предизвика и двете събития, popstate е първо.
history.pushState() добавя запис, а history.replaceState() обновява текущия запис. Нито едно от двете извиквания само по себе си не предизвиква нито едно от тези събития, дори да промени фрагмента. Покажи началния изглед самостоятелно и го обнови директно след успешна промяна на историята в твоя код. Ако слушаш и за двете събития, избягвай да прилагаш една и съща актуализация два пъти.
Примери
<!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>Резултат
after writes: #details
popstate: {"view":"overview"}
hashchange: #details -> #overviewЗапази примера като `index.html`, предостави достъп до него през HTTP(S) и го отвори в отделен тестов раздел: примерът променя записи в историята. Отвори конзолата за разработчици и натисни бутона „Run history demo“ на страницата. Двата записа в историята не предизвикват нито едно от събитията; при асинхронното връщане конзолата показва състоянието `overview` и промяната на фрагмента.
Свързани уроци
- JavaScript · Урок 36 · Средно · Версия: 3
- JavaScript · Урок 37 · Средно · Версия: 3