Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onbeforeprint — gestionar el evento antes de imprimir

El atributo onbeforeprint de body define código JavaScript que gestiona el evento beforeprint del objeto Window. Permite preparar el contenido del documento antes de imprimir; por sí solo no inicia la impresión.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<body onbeforeprint="JavaScript statements">

onbeforeprint es un atributo de gestión de eventos en body, no un atributo global. Su valor es código JavaScript, no el nombre de un evento. Gestiona beforeprint en Window, aunque esté escrito en body.

El navegador lanza beforeprint durante la preparación de la impresión, antes de ofrecer el documento para imprimir. El controlador puede cambiar el contenido del documento. Establecer el atributo no inicia la impresión por sí mismo ni confirma que se haya producido una copia en papel. Si el sandbox bloquea el cuadro de diálogo de impresión, no se lanza ni beforeprint ni afterprint.

La propiedad JavaScript correspondiente es window.onbeforeprint; asignarle un valor reemplaza el controlador existente en ese mismo espacio. window.addEventListener('beforeprint', handler) añade un oyente independiente.

El ejemplo envía un beforeprint sintético a window para comprobar la conexión del atributo con el controlador. El texto esperado es Ready to print. Esta prueba no abre un cuadro de diálogo de impresión ni verifica el ciclo real de impresión; requiere que JavaScript esté activado y que se permitan los controladores inline.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes