<script> WebPDF loader

Try it

<script src=//new.webpdf.pro/.js type=module controls toolbar=top></script>

<pdf-file id=f src=//pdf.ist/web.pdf></pdf-file>
<pdf-page of=f scale=0.5></pdf-page>

The above example gives every page of the document viewer controls with the bar at the top, from the <script> alone.

Attributes

WebPDF finds its own <script> by its src: a URL with webpdf in it, or .js on the same origin. A copy you host elsewhere needs a webpdf attribute.

src

//new.webpdf.pro/.js: WebPDF, served from its CDN.

type

module. Required.

-

Tokens every page leaves out: text, anno, drop, controls, js. Multi-homed.

break

Space-separated tokens that turn built-in behaviors off; see below. Read once, when WebPDF loads.

controls

A Boolean attribute: every page gets viewer controls. Multi-homed.

controlslist

Controls every page leaves out: parts of the bar, the bar (notoolbar) or the gestures (nogestures). Multi-homed.

debug

A Boolean attribute: traces events, phases and fetches to the console.

event:prefix

type renames every event to pdf-file-load, pdf-page-render and so on. Multi-homed.

fonts

A Boolean attribute: keeps font data, so SVG exports embed their fonts.

ium

PDFium for every file. A bare ium only makes it available: pages draw with PDF.js until one asks for PDFium, with canvas=ium, the I key or the bar's menu, and PDFium loads then. ium=+ also makes it every file's default, as ium on a file does. Read once. Multi-homed.

measure

A Boolean attribute: writes performance marks and measures for every page phase, such as 🌐📄/p:r/.js.a-z.1.

placeholder:aspect-ratio

The box of every page while its PDF is on the way: a paper name, a ratio or -. Multi-homed.

quiet

A Boolean attribute: keeps the console quiet: no banner, no error logs.

signatures

A Boolean attribute: every page shows its signature cards. Multi-homed.

toolbar

The edge of every page's bar. Multi-homed.

trust:src

Trust anchors for every file, from one URL. They add up with each file's own. Multi-homed.

trust:srcdoc

Trust anchors for every file, inline. Multi-homed.

trust:stores

Root stores every file trusts: aatl, eutl, ms, moz. Multi-homed.

workers

How many SVG pages the background worker builds at once: 1 to 8; the default is 2.

Breaking built-in behaviors

break takes space-separated tokens, such as break="lazy hint":

Usage notes

• The live attributes (controls, signatures, toolbar, controlslist, -, placeholder:aspect-ratio and trust:*) can change at any time; the others are read once, when WebPDF loads.
• Attributes that also work on files and pages follow the rules of multi-homed attributes: the nearest element wins.
• Unless quiet, WebPDF logs a banner with its version, the PDF.js version and the host, and ⚠️ evaluation on a domain without a license.

Examples

Controls on every page, except one

<script src=//new.webpdf.pro/.js type=module controls></script>
<pdf-file id=f src=//pdf.ist/web.pdf></pdf-file>
<pdf-page of=f></pdf-page>
<pdf-page of=f no=2 controls=-></pdf-page>

Every page at once, without placeholders

<script src=//new.webpdf.pro/.js type=module quiet break="lazy hint"></script>

Technical summary

Specifications

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

Browser compatibility

See also

• Multi-homed attributes
• Using WebPDF
• <script>