Pull down to refresh...
Release to refresh...
Refreshing...
-
Data Grid
- Overview
-
Data Binding
-
Paging and Scrolling
-
Editing
-
Grouping
-
Filtering and Sorting
- Focused Row
-
Row Drag & Drop
-
Selection
-
Columns
- State Persistence
-
Appearance
-
Templates
-
Data Summaries
-
Master-Detail
-
Export to PDF
-
Export to Excel
-
Adaptability
- Keyboard Navigation
-
Pivot Grid
- Overview
-
Data Binding
-
Field Chooser
-
Features
-
Export to Excel
-
Tree List
- Overview
-
Data Binding
- Sorting
- Paging
-
Editing
- Node Drag & Drop
- Focused Row
-
Selection
-
Filtering
-
Column Customization
- State Persistence
- Adaptability
- Keyboard Navigation
-
Scheduler
- Overview
-
Data Binding
-
Views
-
Features
- Virtual Scrolling
-
Grouping
-
Customization
- Adaptability
-
Html Editor
-
Chat
-
Diagram
- Overview
-
Data Binding
-
Featured Shapes
-
Custom Shapes
-
Document Capabilities
-
User Interaction
- UI Customization
- Adaptability
-
Charts
- Overview
-
Data Binding
-
Area Charts
-
Bar Charts
- Bullet Charts
-
Doughnut Charts
-
Financial Charts
-
Line Charts
-
Pie Charts
-
Point Charts
-
Polar and Radar Charts
-
Range Charts
-
Sparkline Charts
-
Tree Map
-
Funnel and Pyramid Charts
- Sankey Chart
-
Combinations
-
More Features
-
Export
-
Selection
-
Tooltips
-
Zooming
-
-
Gantt
- Overview
-
Data
-
UI Customization
- Strip Lines
- Export to PDF
- Sorting
-
Filtering
-
Gauges
- Overview
-
Data Binding
-
Bar Gauge
-
Circular Gauge
-
Linear Gauge
-
Navigation
- Overview
- Accordion
-
Menu
- Multi View
-
Drawer
-
Tab Panel
-
Tabs
-
Toolbar
- Pagination
-
Tree View
- Right-to-Left Support
-
Layout
-
Tile View
- Splitter
-
Gallery
- Scroll View
- Box
- Responsive Box
- Resizable
-
-
Editors
- Overview
- Autocomplete
-
Calendar
- Check Box
- Color Box
-
Date Box
-
Date Range Box
-
Drop Down Box
-
Number Box
-
Select Box
- Switch
-
Tag Box
- Text Area
- Text Box
- Validation
- Custom Text Editor Buttons
- Right-to-Left Support
- Editor Appearance Variants
-
Forms and Multi-Purpose
- Overview
- Button Group
- Field Set
-
Filter Builder
-
Form
- Radio Group
-
Range Selector
- Numeric Scale (Lightweight)
- Numeric Scale
- Date-Time Scale (Lightweight)
- Date-Time Scale
- Logarithmic Scale
- Discrete scale
- Custom Formatting
- Use Range Selection for Calculation
- Use Range Selection for Filtering
- Image on Background
- Chart on Background
- Customized Chart on Background
- Chart on Background with Series Template
- Range Slider
- Slider
-
Sortable
-
File Management
-
File Manager
- Overview
-
File System Types
-
Customization
-
File Uploader
-
-
Actions and Lists
- Overview
-
Action Sheet
-
Button
- Floating Action Button
- Drop Down Button
-
Context Menu
-
List
-
Lookup
-
Maps
- Overview
-
Map
-
Vector Map
-
Dialogs and Notifications
-
Localization
Related Demos:
Your search did not match any results.
Loading...
React Diagram - 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.
Was this demo helpful?
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
x
import React, { useCallback, useRef } from 'react';
import Diagram, {
CustomShape, Nodes, AutoLayout, ContextToolbox, Toolbox, PropertiesPanel, Group, DiagramTypes,
} from 'devextreme-react/diagram';
import notify from 'devextreme/ui/notify';
import ArrayStore from 'devextreme/data/array_store';
import service from './data.ts';
const shapes = ['team', 'employee'];
const orgItemsDataSource = new ArrayStore({
key: 'ID',
data: service.getOrgItems(),
});
function showToast(text: string) {
notify({
position: {
at: 'top', my: 'top', of: '#diagram', offset: '0 4',
},
message: text,
type: 'warning',
delayTime: 2000,
});
}
function onRequestLayoutUpdate(e: DiagramTypes.RequestLayoutUpdateEvent) {
for (let i = 0; i < e.changes.length; i += 1) {
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;
}
}
}
function itemStyleExpr(obj: { Type: string; }) {
if (obj.Type === 'root') {
return { fill: '#ffcfc3' };
}
if (obj.Type === 'team') {
return { fill: '#b7e3fe' };
}
return { fill: '#bbefcb' };
}
export default function App() {
const diagramRef = useRef(null);
const onRequestEditOperation = useCallback((e) => {
const diagram = diagramRef.current.instance();
if (e.operation === 'addShape') {
if (e.args.shape.type !== 'employee' && e.args.shape.type !== 'team') {
if (e.reason !== 'checkUIElementAvailability') {
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') {
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 += 1) {
if (diagram.getItemById(e.args.shape.attachedConnectorIds[i]).toId !== e.args.shape.id) {
if (e.reason !== 'checkUIElementAvailability') {
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') {
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') {
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') {
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') {
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') {
showToast('A shape text cannot be empty.');
}
e.allowed = false;
}
} else if (e.operation === 'beforeChangeConnectorText') {
e.allowed = false;
}
}, []);
return (
<Diagram
id="diagram"
ref={diagramRef}
onRequestEditOperation={onRequestEditOperation}
onRequestLayoutUpdate={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={orgItemsDataSource}
keyExpr="ID"
textExpr="Name"
typeExpr="Type"
parentKeyExpr="ParentID"
styleExpr={itemStyleExpr}
>
<AutoLayout type="tree" />
</Nodes>
<ContextToolbox shapeIconsPerRow={2} width={100} shapes={shapes as any}>
</ContextToolbox>
<Toolbox shapeIconsPerRow={2}>
<Group title="Items" shapes={shapes as any} />
</Toolbox>
<PropertiesPanel visibility="disabled">
</PropertiesPanel>
</Diagram>
);
}
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx