React File Manager - Overview

The DevExtreme JavaScript FileManager component allows you to display and manage files and directories for different file systems. The FileManager uses file system providers to access file systems.

Use the fileSystemProvider property to configure the component's file system provider. The "File System Types" demo group illustrates how to use the FileManager with different file system providers.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import FileManager, { type FileManagerTypes, Permissions } from 'devextreme-react/file-manager'; import RemoteFileSystemProvider from 'devextreme/file_management/remote_provider'; import { Popup } from 'devextreme-react/popup'; const remoteProvider = new RemoteFileSystemProvider({ endpointUrl: 'https://js.devexpress.com/Demos/NetCore/api/file-manager-file-system-images', }); export default function App() { const [currentPath, setCurrentPath] = useState('Widescreen'); const [popupVisible, setPopupVisible] = useState(false); const [imageItemToDisplay, setImageItemToDisplay] = useState<{ name?: string, url?: string }>({}); const displayImagePopup = useCallback((e: FileManagerTypes.SelectedFileOpenedEvent) => { setPopupVisible(true); setImageItemToDisplay({ name: e.file.name, url: e.file.dataItem.url, }); }, [setPopupVisible, setImageItemToDisplay]); const hideImagePopup = useCallback(() => { setPopupVisible(false); }, [setPopupVisible]); const onCurrentDirectoryChanged = useCallback((e: FileManagerTypes.CurrentDirectoryChangedEvent) => { setCurrentPath(e.component.option('currentPath')); }, [setCurrentPath]); return ( <div> <FileManager currentPath={currentPath} fileSystemProvider={remoteProvider} onSelectedFileOpened={displayImagePopup} onCurrentDirectoryChanged={onCurrentDirectoryChanged}> <Permissions create={true} copy={true} move={true} delete={true} rename={true} upload={true} download={true}> </Permissions> </FileManager> <Popup maxHeight={600} hideOnOutsideClick={true} showCloseButton={true} title={imageItemToDisplay.name} visible={popupVisible} onHiding={hideImagePopup} className="photo-popup-content"> <img src={imageItemToDisplay.url} className="photo-popup-image" /> </Popup> </div> ); }

import React, { useCallback, useState } from 'react'; import FileManager, { Permissions } from 'devextreme-react/file-manager'; import RemoteFileSystemProvider from 'devextreme/file_management/remote_provider'; import { Popup } from 'devextreme-react/popup'; const remoteProvider = new RemoteFileSystemProvider({ endpointUrl: 'https://js.devexpress.com/Demos/NetCore/api/file-manager-file-system-images', }); export default function App() { const [currentPath, setCurrentPath] = useState('Widescreen'); const [popupVisible, setPopupVisible] = useState(false); const [imageItemToDisplay, setImageItemToDisplay] = useState({}); const displayImagePopup = useCallback( (e) => { setPopupVisible(true); setImageItemToDisplay({ name: e.file.name, url: e.file.dataItem.url, }); }, [setPopupVisible, setImageItemToDisplay], ); const hideImagePopup = useCallback(() => { setPopupVisible(false); }, [setPopupVisible]); const onCurrentDirectoryChanged = useCallback( (e) => { setCurrentPath(e.component.option('currentPath')); }, [setCurrentPath], ); return ( <div> <FileManager currentPath={currentPath} fileSystemProvider={remoteProvider} onSelectedFileOpened={displayImagePopup} onCurrentDirectoryChanged={onCurrentDirectoryChanged} > <Permissions create={true} copy={true} move={true} delete={true} rename={true} upload={true} download={true} ></Permissions> </FileManager> <Popup maxHeight={600} hideOnOutsideClick={true} showCloseButton={true} title={imageItemToDisplay.name} visible={popupVisible} onHiding={hideImagePopup} className="photo-popup-content" > <img src={imageItemToDisplay.url} className="photo-popup-image" /> </Popup> </div> ); }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

<!DOCTYPE html> <html 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" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.7/css/dx-gantt.min.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/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>

.photo-popup-content { text-align: center; } .photo-popup-content .photo-popup-image { height: 100%; max-width: 100%; }

using DevExtreme.AspNet.Mvc.FileManagement; using System; using System.IO; using System.Net.Http; using System.Net.Http.Headers; using System.Web; using System.Web.Hosting; using System.Web.Http; using System.Web.Mvc; namespace DevExtreme.MVC.Demos.Controllers.ApiControllers { public class FileManagerImagesApiController : ApiController { static readonly string SampleImagesRelativePath = Path.Combine("Content", "SampleData", "SampleImages"); [System.Web.Http.AcceptVerbs("GET", "POST")] [System.Web.Http.Route("api/file-manager-file-system-images", Name = "FileManagementImagesApi")] public object FileSystem() { var request = new HttpContextWrapper(HttpContext.Current).Request; FileSystemCommand command; Enum.TryParse(request["command"], out command); string arguments = request["arguments"]; var config = new FileSystemConfiguration { Request = request, FileSystemProvider = new PhysicalFileSystemProvider( Path.Combine(HostingEnvironment.ApplicationPhysicalPath, SampleImagesRelativePath), (fileSystemItem, clientItem) => { if(!clientItem.IsDirectory) clientItem.CustomFields["url"] = GetFileItemUrl(fileSystemItem); } ), //uncomment the code below to enable file/directory management //AllowCopy = true, //AllowCreate = true, //AllowMove = true, //AllowDelete = true, //AllowRename = true, //AllowUpload = true, AllowDownload = true, TempDirectory = HttpContext.Current.Server.MapPath("~/App_Data/UploadTemp") }; var processor = new FileSystemCommandProcessor(config); var commandResult = processor.Execute(command, arguments); var result = commandResult.GetClientCommandResult(); return command == FileSystemCommand.Download && commandResult.Success ? CreateDownloadResponse(result) : Request.CreateResponse(result); } string GetFileItemUrl(FileSystemInfo fileSystemItem) { var relativeUrl = "~/" + fileSystemItem.FullName .Replace(HostingEnvironment.ApplicationPhysicalPath, "") .Replace(Path.DirectorySeparatorChar, '/'); return Url.Content(relativeUrl); } HttpResponseMessage CreateDownloadResponse(object result) { var fileContent = result as FileStreamResult; if(fileContent == null) return Request.CreateResponse(result); var response = new HttpResponseMessage() { Content = new StreamContent(fileContent.FileStream) }; response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment") { FileName = fileContent.FileDownloadName }; response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream"); return response; } } }

The component's default security settings provide read-only access to files and directories. Use the permissions property to deny or allow a user to copy, create, move, delete, rename, upload, and download files and directories. You can also specify file restrictions: allowed file extensions (allowedFileExtensions), chunk size (chunkSize) and maximum file size (maxFileSize).

Use the component's itemView property or the view switcher on the toolbar to display file system items as a detailed list or customizable thumbnails.

This demo contains commented out code lines that enable file modification operations. You can uncomment them and configure if necessary.