Skip to content

A phonegap plugin to handle documents (f.e. PDFs) loaded from a URL.

License

Notifications You must be signed in to change notification settings

ti8m/DocumentHandler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DocumentHandler

A PhoneGap plugin to handle documents (e.g. PDFs) loaded from a URL.

Usage

The plugin exposes one method on the window object:

handleDocumentWithURL(successHandler, failureHandler, url)

The parameters:

  • successHandler: Should be a function. Is called when the file download is done and the file is shown to the user.
  • failureHandler: Should be a function. Is called when there was a problem with downloading the file. The function takes an argument which is usually 1 (undefined error). Also see Android section.
  • url: A URL to a document. Any cookies the system has for this server are passed along. This ensures that authenticated downloads also work.

Android

The plugin downloads a document and starts an intent, so that other installed applications can open it.

There is a special failure condition on Android, if the system doesn't have any application that can handle the given MIME type. In this case failureHandler will be called with the error code 53.

iOS

The plugin downloads the document and provides a preview of the document using the Quick Look framework, including the corresponding actions such as copy, print, etc.

Example usage

handleDocumentWithURL(
  function() {console.log('success');},
  function(error) {
    console.log('failure');
    if(error == 53) {
      console.log('No app that handles this file type.');
    }
  }, 
  'https://www.example.com/path/to/document.pdf'
);

About

A phonegap plugin to handle documents (f.e. PDFs) loaded from a URL.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published