CKTIS / HTML
onbeforeprint — Ereignis vor dem Drucken behandeln
Das Attribut onbeforeprint auf body legt JavaScript-Code fest, der das beforeprint-Ereignis des Window-Objekts behandelt. Damit lassen sich Dokumentinhalte vor dem Drucken vorbereiten; der Druck wird dadurch nicht selbst gestartet.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onbeforeprint="JavaScript statements">onbeforeprint ist ein Ereignisbehandlungsattribut auf body und kein globales Attribut. Sein Wert ist JavaScript-Code, kein Ereignisname. Es behandelt beforeprint auf Window, obwohl es auf body steht.
Der Browser löst beforeprint während der Druckvorbereitung aus, bevor das Dokument zum Drucken angeboten wird. Der Handler kann den Dokumentinhalt ändern. Das Setzen des Attributs startet selbst keinen Druck und bestätigt nicht, dass eine Papierkopie erstellt wurde. Wenn eine Sandbox den Druckdialog blockiert, werden weder beforeprint noch afterprint ausgelöst.
Die entsprechende JavaScript-Eigenschaft ist window.onbeforeprint; eine Zuweisung ersetzt den vorhandenen Handler desselben Slots. window.addEventListener('beforeprint', handler) fügt einen unabhängigen Listener hinzu.
Das Beispiel löst ein synthetisches beforeprint auf window aus, um die Verbindung des Attributs mit dem Handler zu prüfen. Der erwartete Text lautet Ready to print. Dieser Test öffnet keinen Druckdialog und überprüft nicht den tatsächlichen Druckablauf; JavaScript muss aktiviert und die Verwendung von Inline-Handlern erlaubt sein.
Beispiele
<!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>Ergebnis
Ready to print
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.