npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

ngx-doc-viewer

v22.0.2

Published

Angular document viewer.

Readme

ngx-doc-viewer

This component can be used to show several different document types in an Angular app.

Documents that are publicly available can be shown in an iframe using the google or office document viewer.

Pdf files and word document that are not publicly available can be shown using the mammoth viewer or pdf viewer by passing an objectUrl.

View demo

Changes

Install the NPM Module

npm install ngx-doc-viewer --save

Angular compatibility

ngx-doc-viewer works with Angular 17.3 and newer (use ngx-doc-viewer 21 for Angular 15 to 17.2). The component does not set a change detection strategy, so it follows the default of the Angular version your app uses:

  • Angular 22 and newer: OnPush
  • Angular 21 and older: Eager (previously called Default)

Projected templates (loadingContent, errorContent, errorActions, officeReloadContent) keep updating with your component's state under both strategies.

The component works with and without zone.js, so it also runs in zoneless apps (provideZonelessChangeDetection()). For the mammoth viewer, see the note on zone.js in the mammoth section.

Usage

1. Import NgxDocViewerModule

@NgModule({
  imports: [NgxDocViewerModule],
})
export class AppModule {}

2. Add DocViewer to component:

<ngx-doc-viewer
  [url]="doc"
  viewer="google"
  style="width:100%;height:50vh;"
></ngx-doc-viewer>

The component now shows an internal loading overlay while external viewers such as Google Docs Viewer and Office Online are initializing, so viewer switches do not appear as a blank panel.

API:

Input:

  • url: document url.
  • viewer: google (default), office, mammoth, pdf or url
  • viewerUrl: only for viewer: 'url'; location of the document renderer. Only use this option for other viewers then google or office.
  • queryParams, e.g. to set language. for google: hl=[lang] e.g. hl=nl
  • disableContent: 'none' | 'all' | 'popout' | 'popout-hide' = 'none':
    • none: no overlay
    • all: adds an overlay to the whole iframe, which makes nothing in the document clickable/selectable
    • popout: adds an overlay over googles popout button or office popout and menu which disables just this button/menu but keeps giving the possibility to select text. The popout button is still visible (for google during a few seconds) but not clickable.
    • popout-hide: see popup, instead of an transparent overlay a white one. This really hides the button but you'll see a white block while loading for the google viewer.
  • overrideLocalhost: documents from the assets folder are not publicly available and therefor won't show in an external viewer (google, office). If the site is already published to public server, then pass that url and if will replace localhost by the other url. Like: overrideLocalhost="https://angular-doc-viewer.web.app/"
  • loadingText: fallback text shown in the built-in loading overlay. Defaults to Loading document...
  • errorTextOverride: fallback text shown in the built-in error overlay. Defaults to the runtime error message.
  • retryButtonText: text used by the built-in retry button in the default error overlay. Defaults to Retry
  • googleFinalRetryDelay: waits this many milliseconds and retries Google once more before showing the error overlay. Defaults to 0
  • officeAutoRetry: automatically retries the Office viewer once after officeRetryDelay. Defaults to false
  • officeRetryDelay: delay in milliseconds before the one-time Office auto retry. Defaults to 3000
  • officeReloadButtonText: text shown in the persistent Office reload button. Defaults to ↻
  • officeReloadButtonTitle: tooltip/title for the persistent Office reload button. Defaults to Reload document
  • secondaryActionText: optional text for a built-in secondary error action button, for example Open source or Download
  • secondaryActionMode: controls the built-in secondary action behavior. Supported values: open or download. Defaults to open

For custom loading markup in Angular, project an ng-template named loadingContent. The template receives $implicit and state with:

  • viewer
  • url
  • phase
  • errorText
  • retry()
  • actionUrl
<ngx-doc-viewer [url]="doc" viewer="office">
  <ng-template #loadingContent let-state>
    <div style="display:flex;gap:8px;align-items:center;">
      <span class="spinner"></span>
      <span>Preparing {{ state.viewer }} preview...</span>
    </div>
  </ng-template>
</ngx-doc-viewer>

To replace the persistent Office reload control, project an ng-template named officeReloadContent:

<ngx-doc-viewer [url]="doc" viewer="office">
  <ng-template #officeReloadContent let-state>
    <span>Reload</span>
  </ng-template>
</ngx-doc-viewer>

For custom error markup in Angular, project an ng-template named errorContent. It receives the same context and can call retry() directly:

<ngx-doc-viewer [url]="doc" viewer="office">
  <ng-template #errorContent let-state>
    <div style="text-align:center;">
      <div>Preview unavailable for {{ state.viewer }}.</div>
      <div>{{ state.actionUrl }}</div>
      <button type="button" (click)="state.retry()">Retry</button>
      <a [href]="state.actionUrl" target="_blank" rel="noreferrer">Open source</a>
    </div>
  </ng-template>
</ngx-doc-viewer>

If you want to keep the default error layout but replace just the actions area, project an ng-template named errorActions:

<ngx-doc-viewer [url]="doc" viewer="office" retryButtonText="Try again">
  <ng-template #errorActions let-state>
    <div style="margin-top: 14px; display: flex; gap: 8px; justify-content: center;">
      <button type="button" (click)="state.retry()">Try again</button>
      <a [href]="state.actionUrl" target="_blank" rel="noreferrer">Open source</a>
    </div>
  </ng-template>
</ngx-doc-viewer>

There are some issues loading document in the google viewer. See: https://stackoverflow.com/questions/40414039/google-docs-viewer-returning-204-responses-no-longer-working-alternatives. If loading pdf's and Word documents, seems to work now with this hack let me know via a Github issue.

  • googleCheckContentLoaded = true | If true it will check by interval if the content is loaded.

  • googleCheckInterval = 3000 | The interval in milliseconds that is checked whether the iframe is loaded.

  • googleMaxChecks = 5 | max number of retries Output:

  • loaded: emitted each time the document is ready, for every viewer (iframe, pdf or mammoth). Can be used to hook into custom loading or telemetry flows.

  • loading: emitted when the viewer enters the loading phase. Payload includes viewer, url, phase, errorText, retry(), and actionUrl.

  • error: emitted when the viewer enters the error phase. Payload includes viewer, url, phase, errorText, retry(), and actionUrl.

  • phaseChange: emitted whenever the internal phase changes to idle, loading, ready, or error.

Styling

The rendered elements have class names you can target from your own CSS:

  • ngx-doc-viewer-iframe: the iframe used by the google, office and url viewers
  • ngx-doc-viewer-object: the object used by the pdf viewer
  • ngx-doc-viewer-overlay: the disableContent overlay

Recent behavior improvements

  • External viewer switches now remount the iframe cleanly when changing between viewers such as Google and Office.
  • A built-in loading overlay is shown while remote viewers are loading.
  • Mammoth rendering now refreshes correctly when switching from an iframe-based viewer back to inline document rendering.

File type support

office viewer

.ppt, .pptx, .doc, .docx, .xls and .xlsx

google viewer

Only files under 25 MB can be previewed with the Google Drive viewer.

The google viewer runs in a sandboxed iframe without downloads: Google sometimes answers with an empty response, which browsers would otherwise save as a gview file. The component reloads the viewer when that happens (see googleCheckContentLoaded) and shows an error when it keeps failing.

Google Drive viewer helps you preview over 15 different file types, listed below:

  • Text files (.TXT)
  • Markup/Code (.CSS, .HTML, .PHP, .C, .CPP, .H, .HPP, .JS)
  • Microsoft Word (.DOC and .DOCX)
  • Microsoft Excel (.XLS and .XLSX)
  • Microsoft PowerPoint (.PPT and .PPTX)
  • Adobe Portable Document Format (.PDF)
  • Apple Pages (.PAGES)
  • Adobe Illustrator (.AI)
  • Adobe Photoshop (.PSD)
  • Tagged Image File Format (.TIFF)
  • Autodesk AutoCad (.DXF)
  • Scalable Vector Graphics (.SVG)
  • PostScript (.EPS, .PS)
  • TrueType (.TTF)
  • XML Paper Specification (.XPS)

Note: Archive files (.ZIP, .RAR) are not supported by the Google Docs embedded viewer despite some community sources claiming otherwise. For the current official list of supported formats, see the Google Drive Help Center.

url

For another external document viewers that should be loaded in an iframe.

For Google Drive

<ngx-doc-viewer
  [url]="'https://drive.google.com/file/d/0B5ImRpiNhCfGZDVhMGEyYmUtZTdmMy00YWEyLWEyMTQtN2E2YzM3MDg3MTZh/preview'"
  viewer="url"
  style="width:100%;height:50vh;"
>
</ngx-doc-viewer>

For the Google Viewer or any other viewer where there is a base url and a parameter for the documentUrl:

<ngx-doc-viewer
  [viewerUrl]="https://docs.google.com/gview?url=%URL%&embedded=true"
  [url]="https://file-examples.com/wp-content/uploads/2017/02/file-sample_100kB.doc"
  viewer="url"
  style="width:100%;height:50vh;"
>
</ngx-doc-viewer>

pdf

.pdf

NOTE: PDF's are shown in the embed tag. Browser support is not guaranteed. If you need to be sure the pdf renders on all browsers you better use PDF.js

mammoth

.docx

The mammoth viewer needs mammoth's browser build (mammoth.browser.min.js) loaded as a global. Pick the setup that matches your app.

Zoneless apps: a script tag

New apps on Angular 21 and newer are zoneless (no zone.js). Add mammoth to index.html:

<script
  src="https://cdnjs.cloudflare.com/ajax/libs/mammoth/1.13.0/mammoth.browser.min.js"
  integrity="sha512-5hAL8cCOeSztnaZ+3xjLAflXeSwJpGrdrH6McLq2Dtl0vfvCQw+jO9q652eMASTNAU8anRvrXnlW9QqzlfN2HA=="
  crossorigin="anonymous"
  referrerpolicy="no-referrer"
></script>

Apps with zone.js: angular.json

A script tag in index.html runs before zone.js, and mammoth 1.13.0 fails when zone.js loads after it (Promise.prototype.then called on incompatible receiver). Load mammoth through angular.json instead; Angular runs these scripts after zone.js:

npm install mammoth --save
"scripts": ["node_modules/mammoth/mammoth.browser.min.js"]

This adds about 400 kB (100 kB gzipped) to the initial bundle. Alternatives:

  • keep the script tag, but use mammoth 1.12.3 or older;
  • or make your app zoneless: add provideZonelessChangeDetection() to the app providers and remove zone.js from polyfills in angular.json. ngx-doc-viewer works without zone.js; the demo app runs zoneless.

My other packages

  • ngx-event-handler: advance event handling like click-outside with serval options: npm | github | demo
  • ngx-edit-inline: basic inline edit component: npm | github | demo