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.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<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 } 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) {
var newItem = {
__KEY__: Date.now(),
name: "New file" + fileExtension,
isDirectory: false,
size: 0
};
directory = directory || this.fileManager.instance.getCurrentDirectory();
if(!directory.isDirectory) {
return false;
}
var 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) {
var items = null;
if(viewArea === "navPane") {
items = [ directory ];
} else {
items = this.fileManager.instance.getSelectedItems();
}
items.forEach(function(item) {
if(item.dataItem) {
item.dataItem.category = newCategory;
}
});
return items.length > 0;
}
}
@NgModule({
imports: [
BrowserModule,
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[];
}
let 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.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@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.5.3/lib/typescript.js',
'@angular': 'npm:@angular',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@6.4.0',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@21.1.6/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@21.1.6/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.4.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.32',
'devexpress-gantt': 'npm:devexpress-gantt@3.0.14',
'devextreme-angular': 'npm:devextreme-angular@21.1.6',
'@devextreme/vdom': 'npm:@devextreme/vdom@1.2.2',
'inferno': 'npm:inferno@7.4.10/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat@7.4.10/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.10/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom@1.0.7/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.10/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode@7.4.10/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class@7.4.10/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras@7.4.10/dist/inferno-extras.min.js'
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts'
},
'devextreme': {
defaultExtension: 'js'
},
'@devextreme/vdom': {
defaultExtension: 'js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js'
}
},
packageConfigPaths: [
"npm:@devextreme/*/package.json",
"npm:@angular/*/package.json",
"npm:@angular/common/*/package.json",
"npm:rxjs/package.json",
"npm:rxjs/operators/package.json",
"npm:devextreme-angular/*/package.json",
"npm:devextreme-angular/ui/*/package.json",
"npm:devextreme-angular/package.json",
"npm:devexpress-diagram/package.json",
"npm:devexpress-gantt/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/21.1.6/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.1.6/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.10.3/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/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>