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.
NOTE
Allowed file extensions: .jpg, .jpeg, .gif, .png
Maximum file size: 4 MB
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!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
import React, { useCallback, useState } from 'react';
import FileUploader, { FileUploaderTypes } from 'devextreme-react/file-uploader';
import ProgressBar from 'devextreme-react/progress-bar';
const allowedFileExtensions = ['.jpg', '.jpeg', '.gif', '.png'];
export default function App() {
const [isDropZoneActive, setIsDropZoneActive] = useState(false);
const [imageSource, setImageSource] = useState<string>('');
const [textVisible, setTextVisible] = useState(true);
const [progressVisible, setProgressVisible] = useState(false);
const [progressValue, setProgressValue] = useState(0);
const onDropZoneEnter = useCallback((e: FileUploaderTypes.DropZoneEnterEvent) => {
if (e.dropZoneElement.id === 'dropzone-external') {
setIsDropZoneActive(true);
}
}, [setIsDropZoneActive]);
const onDropZoneLeave = useCallback((e: FileUploaderTypes.DropZoneLeaveEvent) => {
if (e.dropZoneElement.id === 'dropzone-external') {
setIsDropZoneActive(false);
}
}, [setIsDropZoneActive]);
const onUploaded = useCallback((e: FileUploaderTypes.UploadedEvent) => {
const { file } = e;
const fileReader = new FileReader();
fileReader.onload = () => {
setIsDropZoneActive(false);
setImageSource(fileReader.result as string);
};
fileReader.readAsDataURL(file);
setTextVisible(false);
setProgressVisible(false);
setProgressValue(0);
}, [setImageSource, setIsDropZoneActive, setTextVisible, setProgressVisible, setProgressValue]);
const onProgress = useCallback((e: { bytesLoaded: number; bytesTotal: number; }) => {
setProgressValue((e.bytesLoaded / e.bytesTotal) * 100);
}, [setProgressValue]);
const onUploadStarted = useCallback(() => {
setImageSource('');
setProgressVisible(true);
}, [setImageSource, setProgressVisible]);
return (
<div className="widget-container flex-box">
<span>Profile Picture</span>
<div id="dropzone-external" className={`flex-box ${isDropZoneActive ? 'dx-theme-accent-as-border-color dropzone-active' : 'dx-theme-border-color'}`}>
{imageSource && <img id="dropzone-image" src={imageSource} alt="" />}
{textVisible && (
<div id="dropzone-text" className="flex-box">
<span>Drag & Drop the desired file</span>
<span>…or click to browse for a file instead.</span>
</div>
)}
<ProgressBar
id="upload-progress"
min={0}
max={100}
width="30%"
showStatus={false}
visible={progressVisible}
value={progressValue}
></ProgressBar>
</div>
<FileUploader
id="file-uploader"
dialogTrigger="#dropzone-external"
dropZone="#dropzone-external"
multiple={false}
allowedFileExtensions={allowedFileExtensions}
uploadMode="instantly"
uploadUrl="https://js.devexpress.com/Demos/NetCore/FileUploader/Upload"
visible={false}
onDropZoneEnter={onDropZoneEnter}
onDropZoneLeave={onDropZoneLeave}
onUploaded={onUploaded}
onProgress={onProgress}
onUploadStarted={onUploadStarted}
></FileUploader>
</div>
);
}
import React, { useCallback, useState } from 'react';
import FileUploader from 'devextreme-react/file-uploader';
import ProgressBar from 'devextreme-react/progress-bar';
const allowedFileExtensions = ['.jpg', '.jpeg', '.gif', '.png'];
export default function App() {
const [isDropZoneActive, setIsDropZoneActive] = useState(false);
const [imageSource, setImageSource] = useState('');
const [textVisible, setTextVisible] = useState(true);
const [progressVisible, setProgressVisible] = useState(false);
const [progressValue, setProgressValue] = useState(0);
const onDropZoneEnter = useCallback(
(e) => {
if (e.dropZoneElement.id === 'dropzone-external') {
setIsDropZoneActive(true);
}
},
[setIsDropZoneActive],
);
const onDropZoneLeave = useCallback(
(e) => {
if (e.dropZoneElement.id === 'dropzone-external') {
setIsDropZoneActive(false);
}
},
[setIsDropZoneActive],
);
const onUploaded = useCallback(
(e) => {
const { file } = e;
const fileReader = new FileReader();
fileReader.onload = () => {
setIsDropZoneActive(false);
setImageSource(fileReader.result);
};
fileReader.readAsDataURL(file);
setTextVisible(false);
setProgressVisible(false);
setProgressValue(0);
},
[setImageSource, setIsDropZoneActive, setTextVisible, setProgressVisible, setProgressValue],
);
const onProgress = useCallback(
(e) => {
setProgressValue((e.bytesLoaded / e.bytesTotal) * 100);
},
[setProgressValue],
);
const onUploadStarted = useCallback(() => {
setImageSource('');
setProgressVisible(true);
}, [setImageSource, setProgressVisible]);
return (
<div className="widget-container flex-box">
<span>Profile Picture</span>
<div
id="dropzone-external"
className={`flex-box ${
isDropZoneActive
? 'dx-theme-accent-as-border-color dropzone-active'
: 'dx-theme-border-color'
}`}
>
{imageSource && (
<img
id="dropzone-image"
src={imageSource}
alt=""
/>
)}
{textVisible && (
<div
id="dropzone-text"
className="flex-box"
>
<span>Drag & Drop the desired file</span>
<span>…or click to browse for a file instead.</span>
</div>
)}
<ProgressBar
id="upload-progress"
min={0}
max={100}
width="30%"
showStatus={false}
visible={progressVisible}
value={progressValue}
></ProgressBar>
</div>
<FileUploader
id="file-uploader"
dialogTrigger="#dropzone-external"
dropZone="#dropzone-external"
multiple={false}
allowedFileExtensions={allowedFileExtensions}
uploadMode="instantly"
uploadUrl="https://js.devexpress.com/Demos/NetCore/FileUploader/Upload"
visible={false}
onDropZoneEnter={onDropZoneEnter}
onDropZoneLeave={onDropZoneLeave}
onUploaded={onUploaded}
onProgress={onProgress}
onUploadStarted={onUploadStarted}
></FileUploader>
</div>
);
}
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
window.exports = window.exports || {};
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
jsx: 'react',
},
meta: {
'react': {
'esModule': true,
},
'typescript': {
'exports': 'ts',
},
'devextreme/time_zone_utils.js': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme/viz/palette.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
defaultExtension: 'js',
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'react': 'npm:react@17.0.2/umd/react.development.js',
'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js',
'prop-types': 'npm:prop-types@15.8.1/prop-types.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@23.2.5/cjs',
'devextreme-react': 'npm:devextreme-react@23.2.5/cjs',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.51/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'devextreme': {
defaultExtension: 'js',
},
'devextreme-react': {
main: 'index.js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/localization/messages': {
format: 'json',
defaultExtension: '',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
<!DOCTYPE html>
<html>
<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=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script type="text/javascript" src="config.js"></script>
<script type="text/javascript">
System.import("./index.tsx");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
#dropzone-external {
width: 350px;
height: 350px;
background-color: rgba(183, 183, 183, 0.1);
border-width: 2px;
border-style: dashed;
padding: 10px;
}
#dropzone-external > * {
pointer-events: none;
}
#dropzone-external.dropzone-active {
border-style: solid;
}
.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;
}