html2pdf
Based on eKoopmans/html2pdf
html2pdf converts any webpage or element into a printable PDF entirely client-side using html2canvas and jsPDF.
Getting started
HTML
The simplest way to use html2pdf is to download lib/html2pdf.min.js
to your project folder and include it in your HTML with:
NPM
Install html2pdf and its dependencies using NPM with npm install --save js-html2pdf
.
Note: You can use NPM to create your project, but html2pdf will not run in Node.js, it must be run in a browser.
Usage
Once installed, html2pdf is ready to use. You can create an instance of the html2pdf class or just use its static methods for one time use:
// Get the element to printvar element = document; // Define optional configurationvar options = filename: 'my-file.pdf'; // Create instance of html2pdf classvar exporter = element options; // Download the PDF or...exporter; // Get the jsPDF object to work with itexporter; // You can also use static methods for one time use...optionssource = element;optionsdownload = true;html2pdf;
The same goes when installing it through NPM
// Import the library; var exporter = element options; Html2Pdf;
Options
html2pdf can be configured using an optional options
parameter:
var element = document; ;
The options
parameter has the following optional fields:
Name | Type | Default | Description |
---|---|---|---|
source | Element | undefined | The HTML element to export to PDF (required when using static methods). |
margin | number or array | [10, 10, 10, 10] | PDF margin (in jsPDF units). Can be a single number, [vMargin, hMargin] , or [top, left, bottom, right] . |
filename | string | 'file.pdf' | The default filename of the exported PDF. |
image | object | {type: 'jpeg', quality: 0.95} | The image type and quality used to generate the PDF. See the Extra Features section below. |
enableLinks | boolean | true | If enabled, PDF hyperlinks are automatically added ontop of all anchor tags. |
html2canvas | object | {scale: 2, logging: false} | Configuration options sent directly to html2canvas (see here for usage). |
jsPDF | object | {unit: 'mm', format: 'a4', orientation: 'p'} | Configuration options sent directly to jsPDF (see here for usage). |
Page-breaks
You may add html2pdf
-specific page-breaks to your document by adding the CSS class html2pdf__page-break
to any element (normally an empty div
). For React elements, use className=html2pdf__page-break
. During PDF creation, these elements will be given a height calculated to fill the remainder of the PDF page that they are on. Example usage:
I'm on page 1! I'm on page 2!
Image type and quality
You may customize the image type and quality exported from the canvas by setting the image
option. This must be an object with the following fields:
Name | Type | Default | Description |
---|---|---|---|
type | string | 'jpeg' | The image type. HTMLCanvasElement only supports 'png', 'jpeg', and 'webp' (on Chrome). |
quality | number | 0.95 | The image quality, from 0 to 1. This setting is only used for jpeg/webp (not png). |
These options are limited to the available settings for HTMLCanvasElement.toDataURL(), which ignores quality settings for 'png' images. To enable png image compression, try using the canvas-png-compression shim, which should be an in-place solution to enable png compression via the quality
option.
Dependencies
html2pdf depends on the external packages html2canvas, jsPDF, and native-promise-only. These dependencies are automatically loaded when using NPM or the bundled package.
Contributing
Issues
When submitting an issue, please provide reproducible code that highlights the issue, preferably by creating a fork of this template in StackBlitz (which has html2pdf already loaded). Remember that html2pdf uses html2canvas and jsPDF as dependencies, so it's a good idea to check each of those repositories' issue trackers to see if your problem has already been addressed.
Credits
License
Copyright (c) 2018 Alfredo Irarrazaval