DevExtreme v23.2 is now available.

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

Your search did not match any results.

Editing Restrictions

Our Diagram component allows you to restrict edit operations as needed. To prohibit a specific operation, set its corresponding property within the editing property to false.

In this demo, the onRequestEditOperation function implements complex logic to determine whether an operation is allowed. The reason event parameter indicates whether the event is raised by a user action or via a UI update. If a user tries to perform a prohibited action, an error message is displayed.

Backend API
<dx-diagram id="diagram" (onRequestEditOperation)="requestEditOperationHandler($event)" (onRequestLayoutUpdate)="requestLayoutUpdateHandler($event)" > <dxi-custom-shape category="items" [type]="'root'" baseType="octagon" [defaultText]="'Development'" > </dxi-custom-shape> <dxi-custom-shape category="items" [type]="'team'" [title]="'Team'" baseType="ellipse" [defaultText]="'Team Name'" > </dxi-custom-shape> <dxi-custom-shape category="items" [type]="'employee'" [title]="'Employee'" baseType="rectangle" [defaultText]="'Employee Name'" > </dxi-custom-shape> <dxo-nodes [dataSource]="orgItemsDataSource" keyExpr="ID" typeExpr="Type" textExpr="Name" parentKeyExpr="ParentID" [styleExpr]="itemStyleExpr" > <dxo-auto-layout type="tree"></dxo-auto-layout> </dxo-nodes> <dxo-context-toolbox [width]="100" [shapeIconsPerRow]="2" [shapes]="['team', 'employee']" > <dxi-group category="general" title="General"></dxi-group> </dxo-context-toolbox> <dxo-toolbox [shapeIconsPerRow]="2"> <dxi-group title="Items" [shapes]="['team', 'employee']"></dxi-group> </dxo-toolbox> <dxo-properties-panel visibility="disabled"> </dxo-properties-panel> </dx-diagram>
import { NgModule, Component, ViewChild, enableProdMode, } from '@angular/core'; import { HttpClientModule } from '@angular/common/http'; import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser'; import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; import notify from 'devextreme/ui/notify'; import ArrayStore from 'devextreme/data/array_store'; import { DxDiagramModule, DxDiagramComponent, DxDiagramTypes } from 'devextreme-angular/ui/diagram'; import { Service } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', templateUrl: 'app/app.component.html', styleUrls: ['app/app.component.css'], providers: [Service], preserveWhitespaces: true, }) export class AppComponent { @ViewChild(DxDiagramComponent, { static: false }) diagram: DxDiagramComponent; orgItemsDataSource: ArrayStore; constructor(service: Service) { this.orgItemsDataSource = new ArrayStore({ key: 'ID', data: service.getOrgItems(), }); } showToast(text: string) { notify({ position: { at: 'top', my: 'top', of: '#diagram', offset: '0 4', }, message: text, type: 'warning', delayTime: 2000, }); } requestLayoutUpdateHandler(e: DxDiagramTypes.RequestLayoutUpdateEvent) { for (let i = 0; i < e.changes.length; i++) { if (e.changes[i].type === 'remove') { e.allowed = true; } else if (e.changes[i].data.ParentID !== undefined && e.changes[i].data.ParentID !== null) { e.allowed = true; } } } requestEditOperationHandler(e) { const diagram = this.diagram.instance; if (e.operation === 'addShape') { if (e.args.shape.type !== 'employee' && e.args.shape.type !== 'team') { if (e.reason !== 'checkUIElementAvailability') { this.showToast("You can add only a 'Team' or 'Employee' shape."); } e.allowed = false; } } else if (e.operation === 'deleteShape') { if (e.args.shape.type === 'root') { if (e.reason !== 'checkUIElementAvailability') { this.showToast("You cannot delete the 'Development' shape."); } e.allowed = false; } if (e.args.shape.type === 'team') { for (let i = 0; i < e.args.shape.attachedConnectorIds.length; i++) { if ((diagram.getItemById(e.args.shape.attachedConnectorIds[i]) as any).toId != e.args.shape.id) { if (e.reason !== 'checkUIElementAvailability') { this.showToast("You cannot delete a 'Team' shape that has a child shape."); } e.allowed = false; break; } } } } else if (e.operation === 'resizeShape') { if (e.args.newSize.width < 1 || e.args.newSize.height < 0.75) { if (e.reason !== 'checkUIElementAvailability') { this.showToast('The shape size is too small.'); } e.allowed = false; } } else if (e.operation === 'changeConnection') { const shapeType = e.args.newShape && e.args.newShape.type; if (shapeType === 'root' && e.args.connectorPosition === 'end') { if (e.reason !== 'checkUIElementAvailability') { this.showToast("The 'Development' shape cannot have an incoming connection."); } e.allowed = false; } if (shapeType === 'employee' && e.args.connectorPosition === 'start') { e.allowed = false; } } else if (e.operation === 'changeConnectorPoints') { if (e.args.newPoints.length > 2) { if (e.reason !== 'checkUIElementAvailability') { this.showToast('You cannot add points to a connector.'); } e.allowed = false; } } else if (e.operation === 'beforeChangeShapeText') { if (e.args.shape.type === 'root') { if (e.reason !== 'checkUIElementAvailability') { this.showToast("You cannot change the 'Development' shape's text."); } e.allowed = false; } } else if (e.operation === 'changeShapeText') { if (e.args.text === '') { if (e.reason !== 'checkUIElementAvailability') { this.showToast('A shape text cannot be empty.'); } e.allowed = false; } } else if (e.operation === 'beforeChangeConnectorText') { e.allowed = false; } } itemStyleExpr = ({ Type }: Record<string, string>) => ( { fill: { root: '#ffcfc3', team: '#b7e3fe', }[Type] || '#bbefcb', } ); } @NgModule({ imports: [ BrowserModule, BrowserTransferStateModule, HttpClientModule, DxDiagramModule, ], declarations: [AppComponent], bootstrap: [AppComponent], }) export class AppModule { } platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep #diagram { height: 600px; }
import { Injectable } from '@angular/core'; export class OrgItem { ID: string; Name: string; Type?: string; ParentID?: string; } const orgItems: OrgItem[] = [ { ID: '106', Name: 'Development', Type: 'root', }, { ID: '107', Name: 'WinForms Team', Type: 'team', ParentID: '106', }, { ID: '109', Name: 'Javascript Team', Type: 'team', ParentID: '106', }, { ID: '110', Name: 'ASP.NET Team', Type: 'team', ParentID: '106', }, { ID: '112', Name: 'Ana Trujillo', Type: 'employee', ParentID: '107', }, { ID: '113', Name: 'Antonio Moreno', Type: 'employee', ParentID: '107', }, { ID: '115', Name: 'Christina Berglund', Type: 'employee', ParentID: '109', }, { ID: '116', Name: 'Hanna Moos', Type: 'employee', ParentID: '109', }, { ID: '119', Name: 'Laurence Lebihan', Type: 'employee', ParentID: '110', }, { ID: '122', Name: 'Patricio Simpson', Type: 'employee', ParentID: '110', }, { ID: '123', Name: 'Francisco Chang', Type: 'employee', ParentID: '110', }, ]; @Injectable() export class Service { getOrgItems() { return orgItems; } }
// 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/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.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.6.2/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.2.5/cjs', 'devextreme/bundles/dx.all': 'npm:devextreme@23.2.5/bundles/dx.all.js', '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', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.51', 'devextreme-angular': 'npm:devextreme-angular@23.2.5', '@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.2.5/*/package.json', 'npm:devextreme-angular@23.2.5/ui/*/package.json', 'npm:devextreme-angular@23.2.5/package.json', 'npm:devexpress-diagram@2.2.5/package.json', 'npm:devexpress-gantt@4.1.51/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.2.5/css/dx-diagram.min.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.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>