Toolbar and Context Menu
The FileManager component provides the following UI customization properties:
- The toolbar property specifies the toolbar's visibility and available commands.
- The contextMenu property specifies the context menu's availability and its commands.
The toolbar and context menu support context-invariant and context-sensitive items that can be visible or hidden depending on user action.
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
<dx-file-manager
id="fileManager"
[fileSystemProvider]="fileItems"
(onContextMenuItemClick)="onItemClick($event)"
height="450"
>
<dxo-permissions
[create]="true"
[delete]="true"
[rename]="true"
[download]="true"
>
</dxo-permissions>
<dxo-item-view [showParentFolder]="false">
<dxo-details>
<dxi-column dataField="thumbnail"></dxi-column>
<dxi-column dataField="name"></dxi-column>
<dxi-column
dataField="category"
caption="Category"
width="95"
></dxi-column>
<dxi-column dataField="dateModified"></dxi-column>
<dxi-column dataField="size"></dxi-column>
</dxo-details>
</dxo-item-view>
<dxo-toolbar>
<dxi-item name="showNavPane" [visible]="true"></dxi-item>
<dxi-item name="separator"></dxi-item>
<dxi-item name="create"></dxi-item>
<dxi-item
widget="dxMenu"
location="before"
[options]="newFileMenuOptions"
></dxi-item>
<dxi-item name="refresh"></dxi-item>
<dxi-item name="separator" location="after"></dxi-item>
<dxi-item name="switchView"></dxi-item>
<dxi-file-selection-item name="rename"></dxi-file-selection-item>
<dxi-file-selection-item name="separator"></dxi-file-selection-item>
<dxi-file-selection-item name="delete"></dxi-file-selection-item>
<dxi-file-selection-item name="separator"></dxi-file-selection-item>
<dxi-file-selection-item
widget="dxMenu"
location="before"
[options]="changeCategoryMenuOptions"
></dxi-file-selection-item>
<dxi-file-selection-item name="refresh"></dxi-file-selection-item>
<dxi-file-selection-item name="clearSelection"></dxi-file-selection-item>
</dxo-toolbar>
<dxo-context-menu>
<dxi-item name="create"></dxi-item>
<dxi-item text="Create new file" icon="plus">
<dxi-item
text="Text Document"
[options]="{ extension: '.txt' }"
></dxi-item>
<dxi-item
text="RTF Document"
[options]="{ extension: '.rtf' }"
></dxi-item>
<dxi-item text="Spreadsheet" [options]="{ extension: '.xls' }"></dxi-item>
</dxi-item>
<dxi-item name="rename" [beginGroup]="true"></dxi-item>
<dxi-item name="delete"></dxi-item>
<dxi-item text="Category" icon="tags" [beginGroup]="true">
<dxi-item text="Work" [options]="{ category: 'Work' }"></dxi-item>
<dxi-item
text="Important"
[options]="{ category: 'Important' }"
></dxi-item>
<dxi-item text="Home" [options]="{ category: 'Home' }"></dxi-item>
<dxi-item text="None" [options]="{ category: '' }"></dxi-item>
</dxi-item>
<dxi-item name="refresh"></dxi-item>
</dxo-context-menu>
</dx-file-manager>
import {
NgModule, Component, ViewChild, enableProdMode,
} from '@angular/core';
import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxFileManagerModule, DxFileManagerComponent } from 'devextreme-angular';
import FileManager from 'devextreme/ui/file_manager';
import { Service, FileItem } from './app.service';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
styleUrls: ['app/app.component.css'],
selector: 'demo-app',
templateUrl: 'app/app.component.html',
providers: [Service],
preserveWhitespaces: true,
})
export class AppComponent {
@ViewChild(DxFileManagerComponent, { static: false }) fileManager: DxFileManagerComponent;
fileItems: FileItem[];
newFileMenuOptions: any;
changeCategoryMenuOptions: any;
constructor(service: Service) {
this.fileItems = service.getFileItems();
this.newFileMenuOptions = {
items: [
{
text: 'Create new file',
icon: 'plus',
items: [
{
text: 'Text Document',
options: {
extension: '.txt',
},
},
{
text: 'RTF Document',
options: {
extension: '.rtf',
},
},
{
text: 'Spreadsheet',
options: {
extension: '.xls',
},
},
],
},
],
onItemClick: this.onItemClick.bind(this),
};
this.changeCategoryMenuOptions = {
items: [
{
text: 'Category',
icon: 'tags',
items: [
{
text: 'Work',
options: {
category: 'Work',
},
},
{
text: 'Important',
options: {
category: 'Important',
},
},
{
text: 'Home',
options: {
category: 'Home',
},
},
{
text: 'None',
options: {
category: '',
},
},
],
},
],
onItemClick: this.onItemClick.bind(this),
};
this.onItemClick = this.onItemClick.bind(this);
}
onItemClick({ itemData, viewArea, fileSystemItem }) {
let updated = false;
const extension = itemData.options ? itemData.options.extension : undefined;
const category = itemData.options ? itemData.options.category : undefined;
if (extension) {
updated = this.createFile(extension, fileSystemItem);
} else if (category !== undefined) {
updated = this.updateCategory(category, fileSystemItem, viewArea);
}
if (updated) {
this.fileManager.instance.refresh();
}
}
createFile(fileExtension, directory) {
const newItem = {
__KEY__: Date.now(),
name: `New file${fileExtension}`,
isDirectory: false,
size: 0,
};
directory = directory || this.fileManager.instance.getCurrentDirectory();
if (!directory.isDirectory) {
return false;
}
let array = null;
if (!directory.dataItem) {
array = this.fileItems;
} else {
array = directory.dataItem.items;
if (!array) {
directory.dataItem.items = array = [];
}
}
array.push(newItem);
return true;
}
updateCategory(newCategory, directory, viewArea) {
let items = null;
if (viewArea === 'navPane') {
items = [directory];
} else {
items = this.fileManager.instance.getSelectedItems();
}
items.forEach((item) => {
if (item.dataItem) {
item.dataItem.category = newCategory;
}
});
return items.length > 0;
}
}
@NgModule({
imports: [
BrowserModule,
BrowserTransferStateModule,
DxFileManagerModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
import { Injectable } from '@angular/core';
export class FileItem {
name: string;
isDirectory: boolean;
category?: string;
size?: number;
items?: FileItem[];
}
const fileItems: FileItem[] = [{
name: 'Documents',
isDirectory: true,
category: 'Work',
items: [{
name: 'Projects',
isDirectory: true,
category: 'Work',
items: [{
name: 'About.rtf',
isDirectory: false,
size: 1024,
}, {
name: 'Passwords.rtf',
isDirectory: false,
category: 'Important',
size: 2048,
}],
}, {
name: 'About.xml',
isDirectory: false,
size: 1024,
}, {
name: 'Managers.rtf',
isDirectory: false,
size: 2048,
}, {
name: 'ToDo.txt',
isDirectory: false,
size: 3072,
}],
}, {
name: 'Images',
isDirectory: true,
category: 'Home',
items: [{
name: 'logo.png',
isDirectory: false,
size: 20480,
}, {
name: 'banner.gif',
isDirectory: false,
size: 10240,
}],
}, {
name: 'System',
isDirectory: true,
category: 'Important',
items: [{
name: 'Employees.txt',
isDirectory: false,
category: 'Important',
size: 3072,
}, {
name: 'PasswordList.txt',
isDirectory: false,
category: 'Important',
size: 5120,
}],
}, {
name: 'Description.rtf',
isDirectory: false,
size: 1024,
}, {
name: 'Description.txt',
isDirectory: false,
size: 2048,
}];
@Injectable()
export class Service {
getFileItems(): FileItem[] {
return fileItems;
}
}
// In real applications, you should not transpile code in the browser.
// You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
window.exports = window.exports || {};
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.17',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17',
'@angular/forms': 'npm:@angular/forms@12.2.17',
'@angular/common': 'npm:@angular/common@12.2.17',
'@angular/compiler': 'npm:@angular/compiler@12.2.17',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js',
'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.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.1.6/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@23.1.6/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.2',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.49',
'devextreme-angular': 'npm:devextreme-angular@23.1.6',
'@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',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
'rxjs': {
defaultExtension: 'js',
},
'rxjs/operators': {
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.12/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common@12.2.17/*/package.json',
'npm:rxjs@7.5.3/package.json',
'npm:rxjs@7.5.3/operators/package.json',
'npm:devextreme-angular@23.1.6/*/package.json',
'npm:devextreme-angular@23.1.6/ui/*/package.json',
'npm:devextreme-angular@23.1.6/package.json',
'npm:devexpress-diagram@2.2.2/package.json',
'npm:devexpress-gantt@4.1.49/package.json',
],
};
System.config(window.config);
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<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.1.5/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.12.0/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import("app").catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>