DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Custom Drop Zone

The 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.

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/24.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