By RoleModel Software
Spider is a set of reusable web components built with Lit. It currently provides:
rm-pdf-viewer: reskinned PDF viewer built on PDF.jsrm-tabs-root,rm-tabs-trigger,rm-tabs-panel: unstyled behavior-first tabs primitives
A customizable PDF viewer web component built on PDF.js. This component provides a reskinned, embeddable PDF viewing experience with text selection, zoom controls, thumbnail navigation, and theme customization.
yarn add @rolemodel/spiderImport once to register all components:
import'@rolemodel/spider'Or import specific component modules from the package distribution output.
yarn dev
yarn testPDF.js is awesome, but you will notice this paragraph in their setup instructions:
The viewer is built on the display layer and is the UI for PDF viewer in Firefox and the other browser extensions within the project. It can be a good starting point for building your own viewer. However, we do ask if you plan to embed the viewer in your own site, that it not just be an unmodified version. Please re-skin it or build upon it.
This component aims to be that skin layer built upon PDF.js packaged in a lovely drop-in web component.
<!doctype html><html><body><rm-pdf-viewersrc="/path/to/document.pdf"></rm-pdf-viewer></body></html><rm-pdf-viewersrc="/document.pdf"><buttonslot="close-button" onclick="window.location.href='/'">
Back to Home
</button></rm-pdf-viewer>| Name | Type | Default | Description |
|---|---|---|---|
src | string | '' | PDF URL/path |
open | boolean | false | Shows the viewer when present/true |
initial-page | number | 1 | Initial page to open |
theme-hue | number | 217 | Theme hue (0-360) |
theme-saturation | number | 89 | Theme saturation (0-100) |
escape-closes-viewer | boolean | false | Closes viewer on Escape when search is not open |
| Slot | Description |
|---|---|
close-button | Custom close action element rendered in the toolbar |
| Method | Description |
|---|---|
loadPDF() | Loads the PDF from src |
printPDF() | Opens browser print flow for the loaded PDF |
downloadPDF() | Downloads the current src |
fitPDFToScreen() | Applies calculated fit-to-screen zoom |
performSearch(term) | Searches text across pages |
goToNextMatch() / goToPreviousMatch() | Navigates search matches |
Tabs are split into three composable components so behavior is provided without enforcing styling.
Owns the active tab state and coordinates triggers/panels.
| Name | Type | Description |
|---|---|---|
active | string | Current active tab name |
Declares a selectable tab trigger.
| Name | Type | Description |
|---|---|---|
name | string | Tab name this trigger controls |
activeClass | string | Class toggled on slotted elements when active |
| Member | Type | Description |
|---|---|---|
isActive | getter | true when this trigger is selected |
activate() | method | Dispatches a tab select event for this trigger |
Declares content for a tab.
| Name | Type | Description |
|---|---|---|
name | string | Tab name this panel belongs to |
| Member | Type | Description |
|---|---|---|
active | getter | true when this panel is visible |
activate() | method | Dispatches a tab select event for this panel |
| Event | Detail | Description |
|---|---|---|
rm-tab-select | { name: string } | Emitted by triggers/panels to request active tab changes |
<rm-tabs-rootclass="tabs" active="first"><divrole="tablist"><rm-tabs-triggername="first" activeClass="active"><buttontype="button">First</button></rm-tabs-trigger><rm-tabs-triggername="second" activeClass="active"><buttontype="button">Second</button></rm-tabs-trigger></div><rm-tabs-panelname="first"><span>First tab content</span></rm-tabs-panel><rm-tabs-panelname="second"><span>Second tab content</span></rm-tabs-panel></rm-tabs-root>MIT