Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onpagereveal — gestione della visualizzazione della pagina

L’attributo onpagereveal su body imposta il gestore dell’evento pagereveal dell’oggetto Window. L’evento si verifica quando il documento inizia a essere renderizzato dopo l’inizializzazione o la riattivazione.

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

Sintassi

<body onpagereveal="JavaScript statements">

onpagereveal è un attributo gestore di eventi collocato su body. Il suo valore contiene istruzioni JavaScript, non il nome di un evento. Anche se è scritto su body, gestisce l’evento pagereveal dell’oggetto Window, non un evento locale di quell’elemento.

Il browser attiva pagereveal una volta per ogni attivazione del documento: durante il rendering iniziale e dopo una riattivazione. Non è un evento che si verifica a ogni fotogramma e non sostituisce load. Il browser può mostrare prima un fotogramma memorizzato nella cache, quindi non è garantito che il gestore venga eseguito prima che compaiano pixel della pagina.

L’oggetto evento è un PageRevealEvent. La sua proprietà viewTransition fa riferimento alla transizione tra documenti associata oppure vale null; l’evento in sé non richiede un’animazione di transizione. Le alternative all’attributo sono window.onpagereveal = handler e window.addEventListener('pagereveal', handler).

Quando viene eseguito, il gestore dell’esempio scrive event.type (pagereveal) nell’attributo data-received dell’elemento body tramite document.body.dataset.received. Non modifica il testo visibile. I due valori true nell’output della console indicano che body ha l’attributo onpagereveal e che window espone la proprietà onpagereveal. Non confermano che il gestore sia stato eseguito. Perché il gestore possa essere eseguito, il browser deve implementare l’evento e consentire l’esecuzione dei gestori di eventi inline; una policy di sicurezza potrebbe bloccarli.

Esempi

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

Risultato

onpagereveal attribute present: true
onpagereveal event property available: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti