CKTIS / HTML
onbeforeprint — obsługa zdarzenia przed drukowaniem
Atrybut onbeforeprint elementu body definiuje kod JavaScript obsługujący zdarzenie beforeprint obiektu Window. Pozwala przygotować zawartość dokumentu przed drukowaniem; sam nie rozpoczyna drukowania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onbeforeprint="JavaScript statements">onbeforeprint to atrybut obsługi zdarzenia na elemencie body, a nie atrybut globalny. Jego wartością jest kod JavaScript, nie nazwa zdarzenia. Obsługuje beforeprint obiektu Window, mimo że jest zapisany na body.
Przeglądarka emituje beforeprint podczas przygotowania drukowania, przed udostępnieniem dokumentu do wydruku. Obsługa może zmienić zawartość dokumentu. Samo ustawienie atrybutu nie uruchamia drukowania ani nie potwierdza powstania papierowego wydruku. Jeśli sandbox blokuje okno drukowania, zdarzenia beforeprint i afterprint nie są emitowane.
W JavaScript odpowiada mu właściwość window.onbeforeprint; przypisanie do niej zastępuje dotychczasową obsługę tego samego slotu. window.addEventListener('beforeprint', handler) pozwala dodać niezależnego słuchacza.
Przykład wysyła syntetyczne beforeprint do window, aby sprawdzić połączenie atrybutu z obsługą. Oczekiwany tekst to Ready to print. Test nie otwiera okna drukowania i nie sprawdza rzeczywistego cyklu drukowania; wymaga włączonego JavaScript i dozwolonej obsługi inline.
Przykłady
<!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>Wynik
Ready to print
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.