PDFPageElement: signature event

Syntax

Use the event name in methods like addEventListener(). WebPDF elements have no onsignature event handler property.

addEventListener("signature", (event) => { })

With event:prefix=type on the <script>, the file or the page, the event is named pdf-page-signature instead.

Event type

A CustomEvent. Inherits from Event.

Event properties

This interface also inherits properties from its parent, Event.

detail

An object:

signatures

The rows of the signatures that hotspot or card stands for, as verify() returns them; see Signature verification results.

open

true when the full card is about to open, false when it is about to close.

Description

Call preventDefault() to keep the built-in card closed, for example to show the signature in your own interface instead.

Examples

Showing your own card

const page = document.querySelector("pdf-page");
page.addEventListener("signature", (event) => {
  event.preventDefault(); // no built-in card
  const [row] = event.detail.signatures;
  alert(`${row.status}: ${row.certificate?.subjectCN ?? row.signerName}`);
});

Specifications

Not part of any specification. <pdf-file> and <pdf-page> are autonomous custom elements defined by WebPDF.pro. It implements:

Browser compatibility

See also

• PDFPageElement.signatures
• verify
• Verifying signatures