KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onbeforeprint — het evenement vóór het afdrukken afhandelen

Het attribuut onbeforeprint op body definieert JavaScript-code die het beforeprint-event van het Window-object afhandelt. Hiermee kun je documentinhoud voorbereiden voordat je afdrukt; het start zelf geen afdruktaak.

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

Syntax

<body onbeforeprint="JavaScript statements">

onbeforeprint is een event-handlerattribuut op body, geen globaal attribuut. De waarde is JavaScript-code, geen eventnaam. Het handelt beforeprint op Window af, hoewel het op body staat.

De browser activeert beforeprint tijdens de voorbereiding van het afdrukken, voordat het document wordt aangeboden om af te drukken. De handler kan de documentinhoud wijzigen. Het instellen van het attribuut start zelf geen afdruktaak en bevestigt niet dat er een papieren exemplaar is gemaakt. Als een sandbox het afdrukdialoogvenster blokkeert, worden beforeprint en afterprint niet geactiveerd.

De bijbehorende JavaScript-eigenschap is window.onbeforeprint; een toewijzing vervangt de bestaande handler in dezelfde slot. window.addEventListener('beforeprint', handler) voegt een onafhankelijke listener toe.

Het voorbeeld verstuurt een synthetische beforeprint naar window om te controleren of het attribuut aan de handler is gekoppeld. De verwachte tekst is Ready to print. Deze test opent geen afdrukdialoogvenster en controleert de echte afdrukcyclus niet; JavaScript moet zijn ingeschakeld en inline handlers moeten zijn toegestaan.

Voorbeelden

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

Resultaat

Ready to print

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen