База знанияИзпитен център
BGБългарски
Избери език13

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

Източници