Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onbeforeprint — gérer l’événement avant l’impression

L’attribut onbeforeprint sur body définit du code JavaScript qui gère l’événement beforeprint de l’objet Window. Il permet de préparer le contenu du document avant l’impression ; il ne lance pas l’impression à lui seul.

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

Syntaxe

<body onbeforeprint="JavaScript statements">

onbeforeprint est un attribut de gestion d’événement sur body, et non un attribut global. Sa valeur est du code JavaScript, pas un nom d’événement. Il gère beforeprint sur Window, même s’il est écrit sur body.

Le navigateur déclenche beforeprint pendant la préparation de l’impression, avant de proposer le document à l’impression. Le gestionnaire peut modifier le contenu du document. Définir l’attribut ne lance pas l’impression à lui seul et ne confirme pas qu’une copie papier a été produite. Si une sandbox bloque la boîte de dialogue d’impression, ni beforeprint ni afterprint ne sont déclenchés.

La propriété JavaScript correspondante est window.onbeforeprint ; lui affecter une valeur remplace le gestionnaire existant dans le même emplacement. window.addEventListener('beforeprint', handler) ajoute un écouteur indépendant.

L’exemple déclenche un beforeprint synthétique sur window pour vérifier le branchement du gestionnaire de l’attribut. Le texte attendu est Ready to print. Ce test n’ouvre pas de boîte de dialogue d’impression et ne vérifie pas le cycle réel d’impression ; JavaScript doit être activé et les gestionnaires inline autorisés.

Exemples

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

Résultat

Ready to print

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources