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

CKTIS / HTML

onpagehide — обработване на напускането на страница

Атрибутът onpagehide върху body регистрира обработчик за събитието pagehide на обекта Window. При събитие, генерирано от браузъра, стойността true на event.persisted показва, че браузърът възнамерява да запази документа за евентуална повторна употреба, а не че действително го запазва.

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

Синтаксис

<body onpagehide="JavaScript statements">

onpagehide е атрибут за обработчик на събитието pagehide. Когато е поставен върху body, той обработва събитието на Window, а не събитие, ограничено до този елемент. Това не е глобален атрибут, наличен върху произволни елементи. Стандартът го предоставя и върху историческия елемент frameset. Стойността му съдържа JavaScript инструкции; обектът на събитието е достъпен като event.

Събитието pagehide се отнася до напускането на страница, а не просто до превключването между раздели. При събитие, генерирано от браузъра, свойството persisted на обекта PageTransitionEvent има стойност false, когато документът се напуска окончателно, и true, когато браузърът възнамерява да го запази за евентуална повторна употреба, например в кеша за навигация назад/напред (bfcache). Стойността true не гарантира нито действително запазване на документа, нито последващото му възстановяване.

Еквивалентът в JavaScript е window.onpagehide = handler; присвояването заменя предишния обработчик на това свойство. window.addEventListener('pagehide', handler) позволява регистрирането на независими слушатели. Примерът изпраща синтетично събитие, за да осигури повторяем резултат: той нито напуска страницата, нито я поставя в bfcache.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
  <output id="result">Waiting</output>
  <script>
    window.dispatchEvent(new PageTransitionEvent('pagehide', {
      persisted: true
    }));
  </script>
</body>
</html>

Резултат

pagehide: persisted=true

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

Източници