Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onbeforeprint — zpracování události před tiskem

Atribut onbeforeprint na body definuje kód JavaScriptu, který zpracovává událost beforeprint objektu Window. Umožňuje připravit obsah dokumentu před tiskem; sám tisk nespouští.

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

Syntaxe

<body onbeforeprint="JavaScript statements">

onbeforeprint je atribut pro obsluhu události na body, nikoli globální atribut. Jeho hodnotou je kód JavaScriptu, ne název události. Zpracovává beforeprint na Window, přestože je zapsán na body.

Prohlížeč vyvolá beforeprint během přípravy tisku, ještě před nabídnutím dokumentu k tisku. Obsluha může změnit obsah dokumentu. Nastavení atributu samo tisk nespustí ani nepotvrzuje, že vznikla papírová kopie. Pokud sandbox zablokuje dialog pro tisk, nevyvolá se ani beforeprint, ani afterprint.

Odpovídající vlastností JavaScriptu je window.onbeforeprint; přiřazení její hodnoty nahradí stávající obsluhu ve stejném slotu. window.addEventListener('beforeprint', handler) přidá nezávislý posluchač.

Příklad odešle syntetickou událost beforeprint objektu window a ověří tak propojení atributu s obsluhou. Očekávaný text je Ready to print. Tento test neotevře dialog pro tisk ani neověří skutečný průběh tisku; vyžaduje zapnutý JavaScript a povolené inline obsluhy.

Příklady

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

Výsledek

Ready to print

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje