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

CKTIS / HTML

onpagereveal — обработване на показването на страницата

Атрибутът onpagereveal върху body задава обработчика за събитието pagereveal на обекта Window. Събитието се задейства, когато документът започне да се визуализира след инициализация или повторно активиране.

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

Синтаксис

<body onpagereveal="JavaScript statements">

onpagereveal е атрибут за обработчик на събитие, поставен върху body. Стойността му съдържа JavaScript инструкции, а не име на събитие. Макар да е записан върху body, той обработва събитието pagereveal на обекта Window, а не локално събитие на този елемент.

Браузърът задейства pagereveal веднъж при всяко активиране на документа: при първоначалното визуализиране и след повторно активиране. Това не е събитие за всеки отделен кадър и не е заместител на load. Браузърът може предварително да покаже кеширан кадър, затова не е гарантирано, че обработчикът ще се изпълни, преди да се появят пиксели от страницата.

Обектът на събитието е PageRevealEvent. Свойството му viewTransition препраща към свързания преход между документи или има стойност null; самото събитие не изисква анимация на прехода. Алтернативи на атрибута са window.onpagereveal = handler и window.addEventListener('pagereveal', handler).

Когато обработчикът в примера се изпълни, той записва стойността на event.type (pagereveal) в атрибута data-received на елемента body чрез document.body.dataset.received. Видимият текст не се променя. Двете стойности true в показания изход на конзолата означават, че body има атрибут onpagereveal и че свойството onpagereveal е достъпно в window. Те не потвърждават, че обработчикът се е изпълнил. За да може обработчикът да се изпълни, браузърът трябва да поддържа събитието и да разрешава изпълнението на обработчици, записани директно в HTML; политика за сигурност може да ги блокира.

Примери

<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpagereveal handler</title></head>
<body onpagereveal="document.body.dataset.received = event.type">
  <script>
    console.log('onpagereveal attribute present: ' + document.body.hasAttribute('onpagereveal'));
    console.log('onpagereveal event property available: ' + ('onpagereveal' in window));
  </script>
</body>
</html>

Резултат

onpagereveal attribute present: true
onpagereveal event property available: true

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

Източници