Repository files navigation

Dropzone is a JavaScript library that turns any HTML element into a dropzone.This means that a user can drag and drop a file onto it, and Dropzone willdisplay file previews and upload progress, and handle the upload for you viaXHR.

It's fully configurable, can be styled according to your needs and is trusted bythousands.

Install:

$ npm install --save dropzone# or with yarn:$ yarn add dropzone

Use asES6 module (recommended):

import{Dropzone}from"dropzone";constdropzone=newDropzone("div#myId",{url:"/file/post"});

or use asCommonJS module:

const{ Dropzone}=require("dropzone");constdropzone=newDropzone("div#myId",{url:"/file/post"});

👉 Checkout our example implementations for differentbundlers

Use the standalone files like this:

<scriptsrc="https://unpkg.com/dropzone@5/dist/min/dropzone.min.js"></script><linkrel="stylesheet"href="https://unpkg.com/dropzone@5/dist/min/dropzone.min.css"type="text/css"/><divclass="my-dropzone"></div><script>// Dropzone has been added as a global variable.constdropzone=newDropzone("div.my-dropzone",{url:"/file/post"});</script>

• 📚 Full documentation
• ⚙️src/options.jsfor all available options

⚠️NOTE: We are currently moving away from IE support to make the librarymore lightweight. If you don't care about IE but about size, you can alreadyopt into6.0.0-beta.1. Please make sure to pin the specific version sinceparts of the API might change slightly. You can always read about the changesin theCHANGELOG file.

If you need support please use thediscussions section orstackoverflow with thedropzone.js tag andnot the GitHub issuestracker. Only post an issue here if you think you discovered a bug.

If you have a feature request or want to discuss something, please use thediscussions as well.

⚠️Please read thecontributing guidelines before youstart working on Dropzone!

• Beautiful by default
• Image thumbnail previews. Simply register the callbackthumbnail(file, data)and display the image wherever you like
• High-DPI screen support
• Multiple files and synchronous uploads
• Progress updates
• Support for large files
  • Chunked uploads (upload large files in smaller chunks)
• Support for Amazon S3 Multipart upload
• Complete theming. The look and feel of Dropzone is just the default theme. Youcan define everything yourself by overwriting the default event listeners.
• Browser image resizing (resize the images before you upload them to yourserver)
• Well tested

See theLICENSE file