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

CKTIS / HTML

onpopstate — обработване на промени в активния запис в историята

Атрибутът onpopstate на body задава обработчика за събитието popstate на обекта Window. Така страницата може да реагира на придвижване из сесийната история, например с Назад и Напред, и да прочете състоянието на целевия запис.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<body onpopstate="handleState(event)">
window.onpopstate = handleState;

onpopstate е атрибут за обработчик на събитие, наличен за body, а не глобален атрибут за произволни елементи. Той предоставя обработчика popstate на обекта Window. Присвояването window.onpopstate = handleState задава същия обработчик; то не създава втори, независим слушател.

popstate е свързано с придвижването из сесийната история, например чрез Назад, Напред или history.back(). Самостоятелното извикване на history.pushState() или history.replaceState() не задейства събитието. В обработчика event.state съдържа възстановеното състояние на целевия запис. То може да бъде null, затова имай предвид това, преди да достъпиш свойствата му.

Последващо присвояване на window.onpopstate заменя предишния обработчик, а присвояването на null го премахва. За независими обработчици използвай window.addEventListener('popstate', handleState). Не приемай popstate за начин за отменяне на навигацията.

Примерът умишлено изпраща синтетично събитие PopStateEvent с фиксирано състояние. Той проверява връзката на атрибута с Window, но не променя историята и не тества реално придвижване в нея. CSP на приложението може да блокира атрибутите за inline обработчици; в такъв случай регистрирай обработчика в разрешен скрипт.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onpopstate demo</title>
</head>
<body onpopstate="document.getElementById('result').textContent = 'step=' + event.state.step">
  <button id="test" type="button">Test</button>
  <output id="result">Ready</output>
  <script>
    document.getElementById('test').addEventListener('click', () => {
      window.dispatchEvent(new PopStateEvent('popstate', {
        state: { step: 1 }
      }));
    });
  </script>
</body>
</html>

Резултат

step=1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници