Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onafterprint — gerir o evento após a impressão

O atributo onafterprint de body define um handler para o evento afterprint do objeto Window. Pode restaurar a interface após o procedimento de impressão, mas não confirma que o documento foi impresso.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<body onafterprint="JavaScript statements">

onafterprint é um atributo de conteúdo de handler de eventos de body. O seu valor contém instruções JavaScript, não um nome de evento nem um valor booleano. Embora esteja escrito em body, gere o evento afterprint do objeto Window, não um evento dirigido ao próprio elemento.

O procedimento de impressão prevê beforeprint antes de propor a impressão e afterprint após os passos relevantes desse procedimento. O handler pode restaurar alterações à interface feitas antes da impressão. Não o considere uma confirmação de sucesso: o utilizador pode recusar a impressão e o evento não confirma que tenha ocorrido uma impressão física.

O atributo corresponde à propriedade window.onafterprint; não são dois espaços independentes para handlers. Uma alternativa é window.addEventListener('afterprint', handler). O exemplo emite deliberadamente um evento sintético para verificar de forma determinística a ligação do atributo a Window, sem abrir a interface de impressão. É necessário ter o JavaScript ativado e permitir handlers inline; uma política CSP pode bloqueá-los.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onafterprint test</title>
</head>
<body onafterprint="document.getElementById('status').textContent = 'afterprint received';">
  <p id="status">Waiting</p>
  <script>
    window.dispatchEvent(new Event('afterprint'));
  </script>
</body>
</html>

Resultado

afterprint received

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.

Fontes