ng2-pdf-viewer

What is ng2-pdf-viewer?

ng2-pdf-viewer is an Angular component for viewing PDF files. It provides a simple way to display PDF documents in your Angular applications with various customization options.

What are ng2-pdf-viewer's main functionalities?

Basic PDF Viewing

This feature allows you to display a PDF file in your Angular application. The 'src' attribute specifies the path to the PDF file, and 'render-text' enables text rendering.

<pdf-viewer [src]="'path/to/pdf-file.pdf'" [render-text]="true"></pdf-viewer>

Pagination

This feature allows you to navigate through the pages of a PDF document. The 'page' attribute specifies the current page, and you can use buttons to change the page.

<pdf-viewer [src]="'path/to/pdf-file.pdf'" [page]="page"></pdf-viewer>
<button (click)="page = page - 1">Previous</button>
<button (click)="page = page + 1">Next</button>

Zoom

This feature allows you to zoom in and out of the PDF document. The 'zoom' attribute specifies the zoom level, and you can use buttons to adjust the zoom level.

<pdf-viewer [src]="'path/to/pdf-file.pdf'" [zoom]="zoom"></pdf-viewer>
<button (click)="zoom = zoom + 0.1">Zoom In</button>
<button (click)="zoom = zoom - 0.1">Zoom Out</button>

Rotation

This feature allows you to rotate the PDF document. The 'rotation' attribute specifies the rotation angle, and you can use a button to rotate the document by 90 degrees.

<pdf-viewer [src]="'path/to/pdf-file.pdf'" [rotation]="rotation"></pdf-viewer>
<button (click)="rotation = rotation + 90">Rotate</button>

Text Layer

This feature enables the text layer, which makes the text in the PDF selectable and searchable. The 'render-text' attribute is set to true to enable this feature.

<pdf-viewer [src]="'path/to/pdf-file.pdf'" [render-text]="true"></pdf-viewer>

Other packages similar to ng2-pdf-viewer

pdfjs-dist

pdfjs-dist is a library that provides a low-level API to render PDF documents using JavaScript. It is more flexible and powerful but requires more effort to integrate into an Angular application compared to ng2-pdf-viewer.

ngx-extended-pdf-viewer

ngx-extended-pdf-viewer is another Angular component for viewing PDF files. It offers more features and customization options than ng2-pdf-viewer, such as support for forms, annotations, and a built-in toolbar.

react-pdf

react-pdf is a React component for viewing PDF files. While it is not for Angular, it offers similar functionalities to ng2-pdf-viewer for React applications, including basic viewing, pagination, and zooming.

README

Angular PDF Viewer

PDF Viewer Component for Angular 5+

Demo page

https://vadimdez.github.io/ng2-pdf-viewer/

Stackblitz Example

https://stackblitz.com/edit/ng2-pdf-viewer

Blog post

https://medium.com/@vadimdez/render-pdf-in-angular-4-927e31da9c76

Overview

• Install
• Usage
• Options
• Render local PDF file
• Set custom path to the worker
• Search in the PDF
• Contribute

Install

Angular >= 12

npm install ng2-pdf-viewer

Partial Ivy compilated library bundles.

Angular >= 4

npm install ng2-pdf-viewer@^7.0.0

Angular < 4

npm install ng2-pdf-viewer@~3.0.8

Usage

In case you're using systemjs see configuration here.

Add PdfViewerModule to your module's imports

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';

import { PdfViewerModule } from 'ng2-pdf-viewer';

@NgModule({
  imports: [BrowserModule, PdfViewerModule],
  declarations: [AppComponent],
  bootstrap: [AppComponent]
})

class AppModule {}

platformBrowserDynamic().bootstrapModule(AppModule);

And then use it in your component

import { Component } from '@angular/core';

@Component({
  selector: 'example-app',
  template: `
  <pdf-viewer [src]="pdfSrc"
              [render-text]="true"
              [original-size]="false"
              style="width: 400px; height: 500px"
  ></pdf-viewer>
  `
})
export class AppComponent {
  pdfSrc = "https://vadimdez.github.io/ng2-pdf-viewer/assets/pdf-test.pdf";
}

Options

• [src]
• [(page)]
• [stick-to-page]
• [external-link-target]
• [render-text]
• [render-text-mode]
• [rotation]
• [zoom]
• [zoom-scale]
• [original-size]
• [fit-to-page]
• [show-all]
• [autoresize]
• [c-maps-url]
• [show-borders]
• (after-load-complete)
• (page-rendered)
• (text-layer-rendered)
• (error)
• (on-progress)

[src]

Property	Type	Required
[src]	string, object, UInt8Array	Required

Pass pdf location

[src]="'https://vadimdez.github.io/ng2-pdf-viewer/assets/pdf-test.pdf'"

For more control you can pass options object to [src]. See other attributes for the object here.

Options object for loading protected PDF would be:

{
 url: 'https://vadimdez.github.io/ng2-pdf-viewer/assets/pdf-test.pdf',
 withCredentials: true
}

[page]

Property	Type	Required
[page] or [(page)]	number	Required with [show-all]="false" or Optional with [show-all]="true"

Page number

[page]="1"

supports two way data binding as well

[(page)]="pageVariable"

If you want that the two way data binding actually updates your page variable on page change/scroll - you have to be sure that you define the height of the container, for example:

pdf-viewer {
    height: 100vh;
}

[stick-to-page]

Property	Type	Required
[stick-to-page]	boolean	Optional

Sticks view to the page. Works in combination with [show-all]="true" and page.

[stick-to-page]="true"

[render-text]

Property	Type	Required
[render-text]	boolean	Optional

Enable text rendering, allows to select text

[render-text]="true"

[render-text-mode]

Property	Type	Required
[render-text-mode]	RenderTextMode	Optional

Used in combination with [render-text]="true"

Controls if the text layer is enabled, and the selection mode that is used.

0 = RenderTextMode.DISABLED - disable the text selection layer

1 = RenderTextMode.ENABLED - enables the text selection layer

2 = RenderTextMode.ENHANCED - enables enhanced text selection

[render-text-mode]="1"

[external-link-target]

Property	Type	Required
[external-link-target]	string	Optional

Used in combination with [render-text]="true"

Link target

• blank
• none
• self
• parent
• top

[external-link-target]="'blank'"

[rotation]

Property	Type	Required
[rotation]	number	Optional

Rotate PDF

Allowed step is 90 degree, ex. 0, 90, 180

[rotation]="90"

[zoom]

Property	Type	Required
[zoom]	number	Optional

Zoom pdf

[zoom]="0.5"

[zoom-scale]

Property	Type	Required
[zoom-scale]	'page-width'|'page-fit'|'page-height'	Optional

Defines how the Zoom scale is computed when [original-size]="false", by default set to 'page-width'.

• 'page-width' with zoom of 1 will display a page width that take all the possible horizontal space in the container

• 'page-height' with zoom of 1 will display a page height that take all the possible vertical space in the container

• 'page-fit' with zoom of 1 will display a page that will be scaled to either width or height to fit completely in the container

[zoom-scale]="'page-width'"

[original-size]

Property	Type	Required
[original-size]	boolean	Optional

• if set to true - size will be as same as original document
• if set to false - size will be as same as container block

[original-size]="true"

[fit-to-page]

Property	Type	Required
[fit-to-page]	boolean	Optional

Works in combination with [original-size]="true". You can show your document in original size, and make sure that it's not bigger then container block.

[fit-to-page]="false"

[show-all]

Property	Type	Required
[show-all]	boolean	Optional

Show single or all pages altogether

[show-all]="true"

[autoresize]

Property	Type	Required
[autoresize]	boolean	Optional

Turn on or off auto resize.

!Important To make [autoresize] work - make sure that [original-size]="false" and pdf-viewer tag has max-width or display are set.

[autoresize]="true"

[c-maps-url]

Property	Type	Required
[c-maps-url]	string	Optional

Url for non-latin characters source maps.

[c-maps-url]="'assets/cmaps/'"

Default url is: https://unpkg.com/pdfjs-dist@2.0.550/cmaps/

To serve cmaps on your own you need to copy node_modules/pdfjs-dist/cmaps to assets/cmaps.

[show-borders]

Property	Type	Required
[show-borders]	boolean	Optional

Show page borders

[show-borders]="true"

(after-load-complete)

Property	Type	Required
(after-load-complete)	callback	Optional

Get PDF information with callback

First define callback function "callBackFn" in your controller,

callBackFn(pdf: PDFDocumentProxy) {
   // do anything with "pdf"
}

And then use it in your template:

(after-load-complete)="callBackFn($event)"

(page-rendered)

Property	Type	Required
(page-rendered)	callback	Optional

Get event when a page is rendered. Called for every page rendered.

Define callback in your component:

pageRendered(e: CustomEvent) {
  console.log('(page-rendered)', e);
}

And then bind it to <pdf-viewer>:

(page-rendered)="pageRendered($event)"

(pages-initialized)

Property	Type	Required
(pages-initialized)	callback	Optional

Get event when the pages are initialized.

Define callback in your component:

pageInitialized(e: CustomEvent) {
  console.log('(pages-initialized)', e);
}

And then bind it to <pdf-viewer>:

(pages-initialized)="pageInitialized($event)"

(text-layer-rendered)

Property	Type	Required
(text-layer-rendered)	callback	Optional

Get event when a text layer is rendered.

Define callback in your component:

textLayerRendered(e: CustomEvent) {
  console.log('(text-layer-rendered)', e);
}

And then bind it to <pdf-viewer>:

(text-layer-rendered)="textLayerRendered($event)"

(error)

Property	Type	Required
(error)	callback	Optional

Error handling callback

Define callback in your component's class

onError(error: any) {
  // do anything
}

Then add it to pdf-component in component's template

(error)="onError($event)"

(on-progress)

Property	Type	Required
(on-progress)	callback	Optional

Loading progress callback - provides progress information total and loaded bytes. Is called several times during pdf loading phase.

Define callback in your component's class

onProgress(progressData: PDFProgressData) {
  // do anything with progress data. For example progress indicator
}

Then add it to pdf-component in component's template

(on-progress)="onProgress($event)"

Render local PDF file

In your html template add input:

<input (change)="onFileSelected()" type="file" id="file">

and then add onFileSelected method to your component:

onFileSelected() {
  let $img: any = document.querySelector('#file');

  if (typeof (FileReader) !== 'undefined') {
    let reader = new FileReader();

    reader.onload = (e: any) => {
      this.pdfSrc = e.target.result;
    };

    reader.readAsArrayBuffer($img.files[0]);
  }
}

Set custom path to the worker

By default the worker is loaded from cdn.jsdelivr.net.

In your code update path to the worker to be for example /pdf.worker.mjs

(window as any).pdfWorkerSrc = '/pdf.worker.mjs';

This should be set before pdf-viewer component is rendered.

If you ever have a (super rare) edge case where you run in an environment that multiple components are somehow loaded within the same web page, sharing the same window, but using different versions of pdf.worker, support has been added. You can do the above, except that you can append the specific version of pdfjs required and override the custom path just for that version. This way setting the global window var won't conflict.

(window as any)["pdfWorkerSrc2.14.305"] = '/pdf.worker.mjs';

Search in the PDF

Use eventBus for the search functionality.

In your component's ts file:

• Add reference to pdf-viewer component,
• then when needed execute search() like this:

@ViewChild(PdfViewerComponent) private pdfComponent: PdfViewerComponent;

search(stringToSearch: string) {
  this.pdfComponent.eventBus.dispatch('find', {
    query: stringToSearch, type: 'again', caseSensitive: false, findPrevious: undefined, highlightAll: true, phraseSearch: true
  });
}

Contribute

See CONTRIBUTING.md

Donation

If this project help you reduce time to develop, you can give me a cup of tea :)

License

MIT © Vadym Yatsyuk

Changelog

10.3.4 - 31.10.2024

• [#1145] - After upgrade to the version 10.3.3, the first page of pdf is always rendered twice, with different dimension in viewport each time
• [#1146] - Fix: use page init for first updateSize