Editing Restrictions
The Diagram widget allows you to restrict edit operations. To prohibit an operation, set the corresponding option in the editing property to false.
In this demo, the onRequestEditOperation function implements a complex logic to determine whether an operation is allowed. The updateUI event parameter indicates whether the event is raised by user actions or UI update. If a user tries to perform a prohibited action, an error message is displayed.
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.
import React from 'react';
import Diagram, { CustomShape, Nodes, AutoLayout, ContextToolbox, Toolbox, PropertiesPanel, Group } from 'devextreme-react/diagram';
import notify from 'devextreme/ui/notify';
import ArrayStore from 'devextreme/data/array_store';
import service from './data.js';
class App extends React.Component {
constructor(props) {
super(props);
this.orgItemsDataSource = new ArrayStore({
key: 'ID',
data: service.getOrgItems()
});
this.onRequestEditOperation = this.onRequestEditOperation.bind(this);
this.onRequestLayoutUpdate = this.onRequestLayoutUpdate.bind(this);
}
render() {
return (
<Diagram id="diagram" onRequestEditOperation={this.onRequestEditOperation} onRequestLayoutUpdate={this.onRequestLayoutUpdate}>
<CustomShape category="items" type="root" baseType="octagon"
defaultText="Development" />
<CustomShape category="items" type="team" baseType="ellipse"
title="Team" defaultText="Team Name" />
<CustomShape category="items" type="employee" baseType="rectangle"
title="Employee" defaultText="Employee Name" />
<Nodes dataSource={this.orgItemsDataSource} keyExpr="ID" textExpr="Name" typeExpr="Type" parentKeyExpr="ParentID">
<AutoLayout type="tree" />
</Nodes>
<ContextToolbox shapeIconsPerRow={2} width={100} shapes={['team', 'employee']}>
</ContextToolbox>
<Toolbox shapeIconsPerRow={2}>
<Group title="Items" shapes={['team', 'employee']} />
</Toolbox>
<PropertiesPanel visibility="disabled">
</PropertiesPanel>
</Diagram>
);
}
showToast(text) {
notify({
position: { at: 'top', my: 'top', of: '#diagram', offset: '0 4' },
message: text,
type: 'warning',
delayTime: 2000
});
}
onRequestLayoutUpdate(e) {
for(var 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;
}
}
}
onRequestEditOperation(e) {
var dataItem;
if(e.operation === 'addShape') {
if(e.args.shape.type !== 'employee' && e.args.shape.type !== 'team') {
!e.updateUI && this.showToast('You can add only a \'Team\' or \'Employee\' shape.');
e.allowed = false;
}
}
else if(e.operation === 'deleteShape') {
dataItem = e.args.shape && e.args.shape.dataItem;
if(dataItem && dataItem.Type === 'root') {
!e.updateUI && this.showToast('You cannot delete the \'Development\' shape.');
e.allowed = false;
}
if(dataItem && dataItem.Type === 'team') {
var children = service.getOrgItems().filter(function(item) {
return item.ParentID === dataItem.ID;
});
if(children.length > 0) {
!e.updateUI && this.showToast('You cannot delete a \'Team\' shape that has a child shape.');
e.allowed = false;
}
}
}
else if(e.operation === 'resizeShape') {
if(e.args.newSize.width < 1 || e.args.newSize.height < 0.75) {
!e.updateUI && this.showToast('The shape size is too small.');
e.allowed = false;
}
}
else if(e.operation === 'changeConnection') {
dataItem = e.args.newShape && e.args.newShape.dataItem;
if(dataItem && dataItem.Type === 'root' && e.args.connectorPosition === 'end') {
!e.updateUI && this.showToast('The \'Development\' shape cannot have an incoming connection.');
e.allowed = false;
}
if(dataItem && dataItem.Type === 'team' && e.args.connectorPosition === 'end') {
if(dataItem && dataItem.ParentID !== undefined && dataItem.ParentID !== null) {
!e.updateUI && this.showToast('A \'Team\' shape can have only one incoming connection.');
e.allowed = false;
}
}
if(dataItem && dataItem.Type === 'employee') {
if(e.args.connectorPosition === 'start') {
e.allowed = false;
}
if(e.args.connectorPosition === 'end' && dataItem.ParentID !== undefined && dataItem.ParentID !== null) {
!e.updateUI && this.showToast('An \'Employee\' shape can have only one incoming connection.');
e.allowed = false;
}
}
}
else if(e.operation === 'changeConnectorPoints') {
if(e.args.newPoints.length > 2) {
!e.updateUI && this.showToast('You cannot add points to a connector.');
e.allowed = false;
}
}
else if(e.operation === 'beforeChangeShapeText') {
dataItem = e.args.shape && e.args.shape.dataItem;
if(dataItem && dataItem.Type === 'root') {
!e.updateUI && this.showToast('You cannot change the \'Development\' shape\'s text.');
e.allowed = false;
}
}
else if(e.operation === 'changeShapeText') {
if(e.args.text === '') {
!e.updateUI && this.showToast('A shape text cannot be empty.');
e.allowed = false;
}
}
else if(e.operation === 'beforeChangeConnectorText') {
e.allowed = false;
}
}
}
export default App;
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/20.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx-diagram.css" />
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.css" />
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="https://unpkg.com/core-js@2.4.1/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.js');
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
#diagram {
height: 600px;
}
var orgItems = [{
'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'
}];
export default {
getOrgItems() {
return orgItems;
}
};
System.config({
transpiler: 'plugin-babel',
meta: {
},
paths: {
'npm:': 'https://unpkg.com/'
},
defaultExtension: 'js',
map: {
'react': 'npm:react@16.14.0/umd/react.development.js',
'react-dom': 'npm:react-dom@16.14.0/umd/react-dom.development.js',
'prop-types': 'npm:prop-types@15.7.2/prop-types.js',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.25.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@20.2.3',
'devextreme-react': 'npm:devextreme-react@20.2.3',
'jszip': 'npm:jszip@3.5.0/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@0.9.5/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.0.0/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@2.0.0/dist/dx-gantt.js',
'preact': 'npm:preact@10.5.5/dist/preact.js',
'preact/hooks': 'npm:preact@10.5.5/hooks/dist/hooks.js',
// 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'
},
packages: {
'devextreme': {
defaultExtension: 'js'
},
'devextreme-react': {
main: 'index.js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js'
}
},
babelOptions: {
sourceMaps: false,
stage0: true,
react: true
}
});