Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onbeforeprint — gestire l’evento prima della stampa

L’attributo onbeforeprint su body definisce codice JavaScript che gestisce l’evento beforeprint dell’oggetto Window. Consente di preparare il contenuto del documento prima della stampa; da solo non avvia la stampa.

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

Sintassi

<body onbeforeprint="JavaScript statements">

onbeforeprint è un attributo per la gestione degli eventi su body, non un attributo globale. Il suo valore è codice JavaScript, non il nome di un evento. Gestisce beforeprint su Window, anche se è scritto su body.

Il browser genera beforeprint durante la preparazione della stampa, prima di offrire il documento per la stampa. Il gestore può modificare il contenuto del documento. Impostare l’attributo non avvia la stampa e non conferma che sia stata prodotta una copia cartacea. Se il sandbox blocca la finestra di dialogo di stampa, non vengono generati né beforeprint né afterprint.

La proprietà JavaScript corrispondente è window.onbeforeprint; assegnarle un valore sostituisce il gestore esistente nello stesso slot. window.addEventListener('beforeprint', handler) aggiunge un listener indipendente.

L’esempio invia un beforeprint sintetico a window per verificare il collegamento dell’attributo al gestore. Il testo previsto è Ready to print. Questo test non apre una finestra di dialogo di stampa né verifica il ciclo di stampa effettivo; richiede JavaScript attivo e gestori inline consentiti.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onbeforeprint demo</title>
</head>
<body onbeforeprint="document.getElementById('status').textContent = 'Ready to print';">
  <p id="status">Not prepared</p>
  <script>
    window.dispatchEvent(new Event('beforeprint'));
  </script>
</body>
</html>

Risultato

Ready to print

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