CKTIS / HTML
onpageshow — обработване на показването на страница
Атрибутът onpageshow на body свързва JavaScript код със събитието pageshow на обекта Window. Той обработва както показването на новозареден документ, така и повторното показване на запазен документ при навигация в историята.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<body onpageshow="JavaScript code">onpageshow е атрибут за обработване на събития, записан в елемента body. Стойността му е JavaScript код, а не булева стойност. Въпреки мястото си в маркировката той обработва събитието pageshow на обекта Window, а не обикновено събитие на елемента body.
При новозареден документ pageshow настъпва след load. Събитието настъпва и когато запазен документ бъде показан отново при навигация в историята. Параметърът event е обект PageTransitionEvent: event.persisted е false за новозареден документ и true за повторно използван документ. Самото използване на бутона Назад не гарантира true, защото браузърът може да зареди документа отново.
Атрибутът на body и свойството window.onpageshow се отнасят до един и същ обработчик на събития; не ги разглеждайте като две независими места за функции. Алтернатива е window.addEventListener('pageshow', handler), което позволява добавянето на независими обработчици. Content Security Policy може да блокира код в атрибутите.
Примерът заменя текста на абзаца с информация за event.persisted. При отваряне на файла като нов документ очакваният текст е pageshow: persisted=false. Ако същият документ бъде възстановен от back/forward кеша, очакваният текст е pageshow: persisted=true; възстановяването не е гарантирано.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onpageshow example</title>
</head>
<body onpageshow="document.getElementById('status').textContent = 'pageshow: persisted=' + event.persisted">
<p id="status">Waiting for pageshow</p>
</body>
</html>Резултат
pageshow: persisted=false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.