Repository files navigation

• Description
• Demo
• Features
• Security
• Setup
• Requirements
  • Mandatory requirements
  • Optional requirements
  • Cross-domain requirements
• Browsers
  • Desktop browsers
  • Mobile browsers
  • Extended browser support information
• Testing
• Support
• License

File Upload widget with multiple file selection, drag&drop support, progressbars, validation and preview images, audio and video for jQuery.
Supports cross-domain, chunked and resumable file uploads and client-sideimage resizing.
Works with any server-side platform (PHP, Python, Ruby on Rails, Java,Node.js, Go etc.) that supports standard HTML form file uploads.

Demo File Upload

• Multiple file upload:
  Allows to select multiple files at once and upload them simultaneously.
• Drag & Drop support:
  Allows to upload files by dragging them from your desktop or file manager anddropping them on your browser window.
• Upload progress bar:
  Shows a progress bar indicating the upload progress for individual files andfor all uploads combined.
• Cancelable uploads:
  Individual file uploads can be canceled to stop the upload progress.
• Resumable uploads:
  Aborted uploads can be resumed with browsers supporting the Blob API.
• Chunked uploads:
  Large files can be uploaded in smaller chunks with browsers supporting theBlob API.
• Client-side image resizing:
  Images can be automatically resized on client-side with browsers supportingthe required JS APIs.
• Preview images, audio and video:
  A preview of image, audio and video files can be displayed before uploadingwith browsers supporting the required APIs.
• No browser plugins (e.g. Adobe Flash) required:
  The implementation is based on open standards like HTML5 and JavaScript andrequires no additional browser plugins.
• Graceful fallback for legacy browsers:
  Uploads files via XMLHttpRequests if supported and uses iframes as fallbackfor legacy browsers.
• HTML file upload form fallback:
  Allows progressive enhancement by using a standard HTML file upload form aswidget element.
• Cross-site file uploads:
  Supports uploading files to a different domain with cross-site XMLHttpRequestsor iframe redirects.
• Multiple plugin instances:
  Allows to use multiple plugin instances on the same webpage.
• Customizable and extensible:
  Provides an API to set individual options and define callback methods forvarious upload events.
• Multipart and file contents stream uploads:
  Files can be uploaded as standard "multipart/form-data" or file contentsstream (HTTP PUT file upload).
• Compatible with any server-side application platform:
  Works with any server-side platform (PHP, Python, Ruby on Rails, Java,Node.js, Go etc.) that supports standard HTML form file uploads.

⚠️ Please read theVULNERABILITIES document for a list offixed vulnerabilities

Please also read theSECURITY document for instructions on how tosecurely configure your Web server for file uploads.

jQuery File Upload can be installed viaNPM:

npm install blueimp-file-upload

This allows you to includejquery.fileupload.js andits extensions vianode_modules, e.g:

<scriptsrc="node_modules/blueimp-file-upload/js/jquery.fileupload.js"></script>

The widget can then be initialized on a file upload form the following way:

$('#fileupload').fileupload();

For further information, please refer to the following guides:

• Main documentation page
• List of all available Options
• The plugin API
• How to setup the plugin on your website
• How to use only the basic plugin.

• jQuery v1.7+
• jQuery UI widget factory v1.9+(included): Required for the basic File Upload plugin, but very lightweightwithout any other dependencies from the jQuery UI suite.
• jQuery Iframe Transport plugin(included): Required forbrowsers without XHR file upload support.

• JavaScript Templates enginev3+: Used to render the selected and uploaded files.
• JavaScript Load Image libraryv2+: Required for the image previews and resizing functionality.
• JavaScript Canvas to Blob polyfillv3+:Required for the resizing functionality.
• blueimp Gallery v2+: Used to display theuploaded images in a lightbox.
• Bootstrap v3+: Used for the demo design.
• Glyphicons Icon set used by Bootstrap.

Cross-domain File Uploadsusing theIframe Transport pluginrequire a redirect back to the origin server to retrieve the upload results. Theexample implementationmakes use ofresult.htmlas a static redirect page for the origin server.

The repository also includes thejQuery XDomainRequest Transport plugin,which enables limited cross-domain AJAX requests in Microsoft Internet Explorer8 and 9 (IE 10 supports cross-domain XHR requests).
The XDomainRequest object allows GET and POST requests only and doesn't supportfile uploads. It is used on theDemo to delete uploaded filesfrom the cross-domain demo file upload service.

The File Upload plugin is regularly tested with the latest browser versions andsupports the following minimal versions:

• Google Chrome
• Apple Safari 4.0+
• Mozilla Firefox 3.0+
• Opera 11.0+
• Microsoft Internet Explorer 6.0+

The File Upload plugin has been tested with and supports the following mobilebrowsers:

• Apple Safari on iOS 6.0+
• Google Chrome on iOS 6.0+
• Google Chrome on Android 4.0+
• Default Browser on Android 2.3+
• Opera Mobile 12.0+

For a detailed overview of the features supported by each browser version andknown operating system / browser bugs, please have a look at theExtended browser support information.

The project comes with three sets of tests:

1. Code linting usingESLint.
2. Unit tests usingMocha.
3. End-to-end tests usingblueimp/wdio.

To run the tests, follow these steps:

1. StartDocker.
2. Install development dependencies:

   npm install

3. Run the tests:

   npmtest

This project is actively maintained, but there is no official support channel.
If you have a question that another developer might help you with, please posttoStack Overflowand tag your question withblueimp jquery file upload.

Released under theMIT license.