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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.