Skip to content

talos/jquery-download

Repository files navigation

jquery-download

This jQuery plugin uses the data: URI to download the DOM of arbitrary elements into files. One file will be downloaded for each selected element. Since the DOM is captured, any javascript-generated content will be included in the download.

See it in action.

Usage

failCallback: (Optional) The browser may not support the data: URI. If this is the case, this function will be called once with the text of each element not downloaded.

    $(selector).download(failCallback);

There is also a utility function you can use to check whether the browser supports the data URI. This will return true if there is support, and false otherwise.

    $().download('support');

Examples

This will download into a browser-named file the contents of the current page view:

    $('html').download();

This would download every svg on the page into a separate file:

   $('svg').download();

This takes advantage of failCallback in case the browser doesn't support the data: uri.

    var failCallback = function(text) {
      alert("Could not download " + text);
    };
    $('#elem').download(failCallback);

Limitations

It is not possible to specify a name for the downloaded file. If at some point arbitrary headers are added to the data: uri spec, this would be possible using Content-Disposition with filename.

There was some discussion about this on the W3.org, but it has not led to any change in the spec.

Any browsers with limited data: uri support will not work, either. The failCallback is your friend.

Links

Fork it from

http://www.github.com/talos/jquery-download

CDN it at

http://talos.github.com/jquery-download/jquery-download.js

http://talos.github.com/jquery-download/jquery-download.min.js

About

jQuery plugin to capture and download the DOM.

Resources

License

Stars

Watchers

Forks

Packages

No packages published