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

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

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

Източници