JavaScript/jQuery File Uploader - Custom Drop Zone

The JavaScript FileUploader component supports the drag-and-drop functionality to upload files.

In this demo, the dropZone property specifies the HTML element in which you can drag and drop files for upload. The dropZoneEnter and dropZoneLeave events allow you to customize the drop zone when the mouse pointer enters and leaves this zone while dragging the file.

Was this demo helpful?

Thank you!

Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.

Thank you for the feedback!

Backend API

$(() => { $('#file-uploader').dxFileUploader({ dialogTrigger: '#dropzone-external', dropZone: '#dropzone-external', multiple: false, allowedFileExtensions: ['.jpg', '.jpeg', '.gif', '.png'], uploadMode: 'instantly', uploadUrl: 'https://js.devexpress.com/Demos/NetCore/FileUploader/Upload', visible: false, onDropZoneEnter({ component, dropZoneElement, event }) { if (dropZoneElement.id === 'dropzone-external') { const items = event.originalEvent.dataTransfer.items; const allowedFileExtensions = component.option('allowedFileExtensions'); const draggedFileExtension = `.${items[0].type.replace(/^image\//, '')}`; const isSingleFileDragged = items.length === 1; const isValidFileExtension = allowedFileExtensions.includes(draggedFileExtension); if (isSingleFileDragged && isValidFileExtension) { toggleDropZoneActive(dropZoneElement, true); } } }, onDropZoneLeave(e) { if (e.dropZoneElement.id === 'dropzone-external') { toggleDropZoneActive(e.dropZoneElement, false); } }, onUploaded(e) { const { file } = e; const dropZoneText = document.getElementById('dropzone-text'); const fileReader = new FileReader(); fileReader.onload = function () { toggleDropZoneActive(document.getElementById('dropzone-external'), false); const dropZoneImage = document.getElementById('dropzone-image'); dropZoneImage.src = fileReader.result; }; fileReader.readAsDataURL(file); dropZoneText.style.display = 'none'; uploadProgressBar.option({ visible: false, value: 0, }); }, onProgress(e) { uploadProgressBar.option('value', (e.bytesLoaded / e.bytesTotal) * 100); }, onUploadStarted() { toggleImageVisible(false); uploadProgressBar.option('visible', true); }, }); const uploadProgressBar = $('#upload-progress').dxProgressBar({ min: 0, max: 100, width: '30%', showStatus: false, visible: false, }).dxProgressBar('instance'); function toggleDropZoneActive(dropZone, isActive) { dropZone.classList.toggle('dropzone-active', isActive); } function toggleImageVisible(visible) { const dropZoneImage = document.getElementById('dropzone-image'); dropZoneImage.hidden = !visible; } document.getElementById('dropzone-image').onload = function () { toggleImageVisible(true); }; });

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.3/css/dx.light.css" /> <script src="js/dx.all.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="widget-container flex-box"> <span>Profile Picture</span> <div id="dropzone-external" class="flex-box"> <img id="dropzone-image" src="#" hidden alt="" /> <div id="dropzone-text" class="flex-box"> <span>Drag & Drop the desired file</span> <span>…or click to browse for a file instead.</span> </div> <div id="upload-progress"></div> </div> <div id="file-uploader"></div> </div> </div> </body> </html>

#dropzone-external { width: 350px; height: 350px; background-color: rgb(183 183 183 / 10%); border-width: 2px; border-style: dashed; padding: 10px; border-color: var(--dx-color-border); } #dropzone-external > * { pointer-events: none; } #dropzone-external.dropzone-active { border-style: solid; border-color: var(--dx-color-primary); } .widget-container > span { font-size: 22px; font-weight: bold; margin-bottom: 16px; } #dropzone-image { max-width: 100%; max-height: 100%; } #dropzone-text > span { font-weight: 100; opacity: 0.5; } #upload-progress { display: flex; margin-top: 10px; } .flex-box { display: flex; flex-direction: column; justify-content: center; align-items: center; }

NOTE

Allowed file extensions: .jpg, .jpeg, .gif, .png

Maximum file size: 4 MB