CKTIS / HTML
onbeforeprint — tratar o evento antes da impressão
O atributo onbeforeprint em body define código JavaScript que trata o evento beforeprint do objeto Window. Permite preparar o conteúdo do documento antes da impressão; por si só, não inicia a impressão.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onbeforeprint="JavaScript statements">onbeforeprint é um atributo de tratamento de eventos em body, não um atributo global. O seu valor é código JavaScript, não o nome de um evento. Trata beforeprint em Window, apesar de estar escrito em body.
O navegador dispara beforeprint durante a preparação da impressão, antes de disponibilizar o documento para impressão. O manipulador pode alterar o conteúdo do documento. Definir o atributo não inicia a impressão nem confirma que foi produzida uma cópia em papel. Se uma sandbox bloquear a caixa de diálogo de impressão, nem beforeprint nem afterprint são disparados.
A propriedade JavaScript correspondente é window.onbeforeprint; atribuir-lhe um valor substitui o manipulador existente no mesmo espaço. window.addEventListener('beforeprint', handler) adiciona um listener independente.
O exemplo envia um beforeprint sintético para window para verificar a ligação do atributo ao manipulador. O texto esperado é Ready to print. Este teste não abre uma caixa de diálogo de impressão nem verifica o ciclo real de impressão; requer JavaScript ativado e manipuladores inline permitidos.
Exemplos
<!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>Resultado
Ready to print
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.