vue-pdf-app
Advanced tools
VUEjs v2 PDF viewer based on Mozilla's PDFJS.
100% PDFJS functionality:
Easily localized configurable panel
Cross-browser support (including IE11)
Color customization (IE11 not supported)
Buttons icons customization
Light/dark themes
Built-in typescript support
UMD/Unpkg support:
| File | Size | Gzipped |
|---|---|---|
| vue-pdf-app.umd.min.js | 1742.89 KiB | 478.86 KiB |
| vue-pdf-app.umd.js | 3115.59 KiB | 677.87 KiB |
| vue-pdf-app.common.js | 3115.12 KiB | 677.71 KiB |
| icons/main.css | 15 - 40 KiB (depends from browser) |
<template>
<vue-pdf-app pdf="http://example.com/sample.pdf"></vue-pdf-app>
</template>
<script>
import VuePdfApp from "vue-pdf-app";
// import this to use default icons for buttons
import "vue-pdf-app/dist/icons/main.css";
export default {
components: {
VuePdfApp
}
};
</script>
string | null | ArrayBuffer | TypedArrayfalse<vue-pdf-app pdf="https://example.com/sample.pdf" />
<vue-pdf-app :pdf="ArrayBuffer" />
true renames document title to pdf file name<vue-pdf-app :title="true" />
"dark" | "light"false<vue-pdf-app theme="dark" />
<vue-pdf-app :theme="theme" />
<vue-pdf-app :theme.sync="theme" />
false for buttons or whole group of buttons to disable them.false<vue-pdf-app :config="config" />
<script>
export default {
data() {
return {
// disable "Previous page" button
config: {
toolbar: {
toolbarViewerLeft: {
previous: false
}
}
},
// disable whole page navigation panel
config2: {
toolbar: {
toolbarViewerLeft: false
}
},
// disable whole panel
config3: {
toolbar: false
}
};
}
};
</script>
{
sidebar: {
viewThumbnail: true,
viewOutline: true,
viewAttachments: true,
},
secondaryToolbar: {
secondaryPresentationMode: true,
secondaryOpenFile: true,
secondaryPrint: true,
secondaryDownload: true,
secondaryViewBookmark: true,
firstPage: true,
lastPage: true,
pageRotateCw: true,
pageRotateCcw: true,
cursorSelectTool: true,
cursorHandTool: true,
scrollVertical: true,
scrollHorizontal: true,
scrollWrapped: true,
spreadNone: true,
spreadOdd: true,
spreadEven: true,
documentProperties: true,
},
toolbar: {
toolbarViewerLeft: {
findbar: true,
previous: true,
next: true,
pageNumber: true,
},
toolbarViewerRight: {
presentationMode: true,
openFile: true,
print: true,
download: true,
viewBookmark: true,
},
toolbarViewerMiddle: {
zoomOut: true,
zoomIn: true,
scaleSelectContainer: true,
},
},
errorWrapper: true,
};
<vue-pdf-app @after-created="afterCreated" />
<vue-pdf-app @open="openHandler" />
<vue-pdf-app @pages-rendered="pagesRendered" />
<script>
export default {
methods: {
pagesRendered(pdfApp) {
setTimeout(() => (pdfApp.pdfViewer.currentScaleValue = "page-height"));
}
}
};
</script>
ℹ️ Events are triggered in the following order
after-created (once) => open => pages-rendered
| Slot name | Slot props | Prop type | Description |
|---|---|---|---|
| toolbar-left-prepend
toolbar-left-append toolbar-left-append toolbar-middle-prepend toolbar-middle-append toolbar-right-prepend toolbar-right-append toolbar-sidebar-prepend toolbar-sidebar-append secondary-toolbar-prepend secondary-toolbar-append footer | toggleTheme | function() | Toggle theme |
<vue-pdf-app>
<template #toolbar-left-prepend="{ toggleTheme }">
<button @click="toggleTheme" type="button">Toggle theme</button>
</template>
</vue-pdf-app>
Colors of the pdf viewer are customized via custom css properties:
<style>
/* for dark theme */
.pdf-app.dark {
--pdf-toolbar-color: black;
}
/* for light theme */
.pdf-app.light {
--pdf-toolbar-color: white;
}
</style>
| Property | Applied to selectors | Description |
|---|---|---|
| --pdf-app-background-color | .pdf-app | Background color for root pdf container |
| --pdf-button-hover-font-color |
.pdf-app .toolbarButton:hover
.pdf-app .toolbarButton:focus .pdf-app .dropdownToolbarButton:hover .pdf-app .secondaryToolbarButton:hover .pdf-app .secondaryToolbarButton:focus | Hover color for buttons of toolbar and secondary toolbar |
| --pdf-button-toggled-color |
.pdf-app .toolbarButton.toggled
.pdf-app .splitToolbarButton.toggled > .toolbarButton.toggled .pdf-app .secondaryToolbarButton.toggled .pdf-app .outlineItemToggler:hover .pdf-app .outlineItemToggler:hover + a .pdf-app .outlineItemToggler:hover ~ .outlineItems .pdf-app .outlineItem > a:hover .pdf-app .attachmentsItem > button:hover |
Background color for toggleable buttons when selected, outline items on hover, attachment items on hover
|
| --pdf-dialog-button-color | .pdf-app .dialog .overlayButton |
|
| --pdf-dialog-button-font-color | .pdf-app .dialog .overlayButton |
|
| --pdf-error-more-info-color | .pdf-app #errorMoreInfo |
|
| --pdf-error-more-info-font-color | .pdf-app #errorMoreInfo |
|
| --pdf-error-wrapper-color | .pdf-app #errorWrapper |
|
| --pdf-find-input-placeholder-font-color | .pdf-app #findInput::placeholder |
|
| --pdf-find-message-font-color | .pdf-app #findMsg |
|
| --pdf-find-results-count-color | .pdf-app #findResultsCount |
|
| --pdf-find-results-count-font-color | .pdf-app #findResultsCount |
|
| --pdf-horizontal-toolbar-separator-color | .pdf-app .horizontalToolbarSeparator |
|
| --pdf-input-color | .pdf-app .toolbarField |
|
| --pdf-input-font-color | .pdf-app .toolbarField |
|
| --pdf-loading-bar-color | .pdf-app #loadingBar .progress |
|
| --pdf-loading-bar-secondary-color | .pdf-app #loadingBar .progress.indeterminate .glimmer |
|
| --pdf-not-found-color | .pdf-app #findInput.notFound |
|
| --pdf-overlay-container-color | .pdf-app #overlayContainer | Background color for overlay container of dialogs |
| --pdf-overlay-container-dialog-color | .pdf-app #overlayContainer > .container > .dialog | Background color for document properties, password, print dialogs |
| --pdf-overlay-container-dialog-font-color | .pdf-app #overlayContainer > .container > .dialog | Font color for document properties, password, print dialogs |
| --pdf-overlay-container-dialog-separator-color | .pdf-app .dialog .separator |
|
| --pdf-sidebar-content-color | .pdf-app #sidebarContent | Background color for sidebar |
| --pdf-split-toolbar-button-separator-color |
.pdf-app .splitToolbarButtonSeparator
.pdf-app .verticalToolbarSeparator |
|
| --pdf-thumbnail-selection-ring-selected-color | .pdf-app .thumbnail.selected > .thumbnailSelectionRing |
Border color for selected thumbnail
|
| --pdf-thumbnail-selection-ring-color |
.pdf-app a:focus > .thumbnail > .thumbnailSelectionRing
.pdf-app .thumbnail:hover > .thumbnailSelectionRing |
Border color for thumbnail on hover and focus
|
| --pdf-toolbar-color |
.pdf-app #toolbarContainer
.pdf-app .findbar .pdf-app .secondaryToolbar .pdf-app .doorHanger:after .pdf-app .doorHangerRight:after .pdf-app .dropdownToolbarButton > select .pdf-app .dropdownToolbarButton > select > option | Background color for toolbar, findbar, secondary toolbar, page scale dropdown |
| --pdf-toolbar-font-color |
.pdf-app .toolbarButton
.pdf-app .dropdownToolbarButton .pdf-app .secondaryToolbarButton .pdf-app .dropdownToolbarButton > select .pdf-app .toolbarLabel .pdf-app .outlineItem > a .pdf-app .attachmentsItem > button | Font color for toolbar, findbar, secondary toolbar, page scale dropdown, attachments name |
| --pdf-toolbar-sidebar-color | .pdf-app #toolbarSidebar |
|
To use default icons import "vue-pdf-app/dist/icons/main.css";.
To use custom icons you have to implement icons.css:
.vue-pdf-app-icon::before,
.vue-pdf-app-icon::after {
font-family: "your font family";
}
.vue-pdf-app-icon.zoom-out::before {
content: "icon code";
}
Toggle theme button is not implemented by default. It's up to you to decide where to place it. The button can be implemented with slots:
<vue-pdf-app>
<template #footer="{ toggleTheme }">
<button @click="toggleTheme" type="button">Toggle theme</button>
</template>
</vue-pdf-app>
English is the default language for panel.
Use <link rel="resource" type="application/l10n" href="path-to-localization-file"> in your html for localization.
See localization file examples.
<!DOCTYPE html>
<html lang="en">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta charset="utf-8" />
<title>Vue-pdf-app demo</title>
<link
rel="stylesheet"
href="https://unpkg.com/vue-pdf-app@2.0.0/dist/icons/main.css"
/>
<script src="https://unpkg.com/vue"></script>
<script src="https://unpkg.com/vue-pdf-app@2.0.0"></script>
</head>
<body>
<div id="app" style="height: 100%;">
<vue-pdf-app pdf="/sample.pdf"></vue-pdf-app>
</div>
<script>
new Vue({
components: {
PdfApp: window["vue-pdf-app"]
}
}).$mount("#app");
</script>
</body>
</html>
<template>
<div id="app">
<vue-pdf-app pdf="/sample.pdf"></vue-pdf-app>
</div>
</template>
<script lang="ts">
import "vue-pdf-app/dist/icons/main.css";
import VuePdfApp from "vue-pdf-app";
import { Component, Vue } from "vue-property-decorator";
@Component({
components: {
VuePdfApp
}
})
export default class App extends Vue {}
</script>
PDFJS is a huge package (see the library size table above). So use lazy loading to split your bundle into small pieces.
<template>
<div id="app">
<vue-pdf-app></vue-pdf-app>
</div>
</template>
<script>
import "vue-pdf-app/dist/icons/main.css";
import Loader from "./components/Loader.vue";
export default {
name: "App",
components: {
"vue-pdf-app": () => ({
component: new Promise((res) => {
return setTimeout(
() => res(import(/* webpackChunkName: "pdf-viewer" */ "vue-pdf-app")),
4000
);
}),
loading: Loader
})
}
};
</script>
You can interact with pdfjs library when pdf is opened via open event.
<template>
<div id="app">
<div id="pdf-wrapper">
<vue-pdf-app pdf="/sample.pdf" @open="openHandler"></vue-pdf-app>
</div>
<div id="info">
<h1>PDF info:</h1>
<div v-for="item in info" :key="item.name">
<span>{{ item.name }}: {{ item.value }}</span>
<br />
</div>
</div>
</div>
</template>
<script>
import "vue-pdf-app/dist/icons/main.css";
import VuePdfApp from "vue-pdf-app";
export default {
name: "App",
components: {
VuePdfApp
},
data() {
return {
info: []
};
},
methods: {
async openHandler(pdfApp) {
this.info = [];
const info = await pdfApp.pdfDocument
.getMetadata()
.catch(console.error.bind(console));
if (!info) return;
const props = Object.keys(info.info);
props.forEach((prop) => {
const obj = {
name: prop,
value: info.info[prop]
};
this.info.push(obj);
});
}
}
};
</script>
v2.0.0
pages-rendered and after-created.title prop.v-bind:config prop. Deleted config.viewerContextMenu and config.toolbar.toolbarViewerRight.secondaryToolbarToggle. Visibility of secondaryToolbarToggle depends from config.secondaryToolbar. Moved prop config.findbar into config.toolbar.toolbarViewerLeft.findbar.v-bind:config toolbar.toolbarViewerMiddle.scaleSelectContatiner prop to toolbar.toolbarViewerMiddle.scaleSelectContainer.window["vue-pdf-app"] instead of window["pdf-viewer"] for script tag.FAQs
Vue 2 pdf viewer
The npm package vue-pdf-app receives a total of 3,890 weekly downloads. As such, vue-pdf-app popularity was classified as popular.
We found that vue-pdf-app demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."