PDFElement: controlsList property

Value

A DOMTokenList of the element's own tokens:

nopaging

‹ › and the page number; First page and Last page.

norotation

⟲ ⟳.

noscale

− % +.

nofullscreen

⛶.

norenderer

PDF.js, PDFium, SVG.

nolayers

Text layer, Annotations.

nosignatures

Signature cards, … on every page.

nocopy

Copy image, Copy as data URL.

nodownload

Save, Save form data.

noopen

Open…, Open form data….

notoolbar

The whole bar, and with it the menu.

nogestures

The swipes, the two-finger twist and the sideways wheel, which then do nothing: two fingers zoom the browser again.

As with <video>, a token only leaves controls out of the bar and the menu: their keys and gestures keep working. notoolbar leaves out the whole bar, and nogestures turns the gestures off; the keys always work. controlsList.supports(token) tells you whether a token is one of these.

The attribute is multi-homed: the tokens of the <script>, the file and the page add up, -token drops an inherited one and a bare - drops them all.

Examples

A read-only viewer

Pages, zoom and fullscreen only: no renderer switch, no copying, no saving, no opening.

HTML

<pdf-file id=f src=//pdf.ist/web.pdf></pdf-file>
<pdf-page of=f controls controlslist="norenderer nolayers nocopy nodownload noopen" scale=0.5></pdf-page>

Result

Feature detection

const page = document.querySelector("pdf-page");
if (page.controlsList.supports("nocopy")) page.controlsList.add("nocopy");

Specifications

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

Browser compatibility

See also

• PDFElement.toolbar
• Viewer controls
• HTMLMediaElement.controlsList