Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onpagereveal — obsługa ujawnienia strony

Atrybut onpagereveal elementu body ustawia procedurę obsługi zdarzenia pagereveal obiektu Window. Zdarzenie występuje przy rozpoczęciu renderowania dokumentu po jego inicjalizacji lub ponownej aktywacji.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<body onpagereveal="JavaScript statements">

onpagereveal jest atrybutem obsługi zdarzenia umieszczanym na elemencie body. Jego wartość zawiera instrukcje JavaScript, a nie nazwę zdarzenia. Choć zapis znajduje się na body, obsługuje zdarzenie pagereveal obiektu Window, nie lokalne zdarzenie tego elementu.

Przeglądarka wysyła pagereveal raz na aktywację dokumentu: przy początkowym renderowaniu oraz po ponownej aktywacji. Nie jest to zdarzenie każdej klatki ani zamiennik load. Przeglądarka może pokazać wcześniej zapamiętaną klatkę, więc procedura nie gwarantuje wykonania przed wyświetleniem jakichkolwiek pikseli strony.

Obiekt zdarzenia ma typ PageRevealEvent. Jego viewTransition wskazuje powiązane przejście między dokumentami albo ma wartość null; samo zdarzenie nie wymaga animacji przejścia. Alternatywami dla atrybutu są window.onpagereveal = handler oraz window.addEventListener('pagereveal', handler).

Gdy procedura obsługi w przykładzie się wykona, zapisuje wartość event.type (pagereveal) w atrybucie data-received elementu body za pośrednictwem document.body.dataset.received. Nie zmienia widocznego tekstu. Dwa wyniki true w pokazanym wyjściu konsoli oznaczają, że body ma atrybut onpagereveal, a window udostępnia właściwość onpagereveal. Nie potwierdzają wykonania procedury obsługi. Aby procedura mogła się wykonać, przeglądarka musi obsługiwać zdarzenie i zezwalać na wykonywanie procedur obsługi zapisanych bezpośrednio w HTML; polityka bezpieczeństwa może je blokować.

Przykłady

<!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>

Wynik

onpagereveal attribute present: true
onpagereveal event property available: true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła