DevExtreme v26.1 is now available.

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

Your search did not match any results.

React Diagram - Containers

This demo shows the Diagram component's capability to wrap shapes into containers. A container is a special shape with the following features:

  • A container can contain other shapes (including other containers).
  • A container is dragged with its content.
  • A container can be collapsed with a collapse button.

To wrap a shape, drop it into a container.

If you bind the Diagram to a data source, define the containerKeyExpr property to store information about the parent container in the data source. Otherwise, this information will be lost.

Backend API
import React, { useEffect, useRef } from 'react'; import Diagram, { Group, Toolbox } from 'devextreme-react/diagram'; import type { DiagramRef } from 'devextreme-react/diagram'; import 'whatwg-fetch'; export default function App() { const diagramRef = useRef<DiagramRef>(null); useEffect(() => { const diagram = diagramRef?.current?.instance(); fetch('../../../../data/diagram-structure.json') .then((response) => response.json()) .then((json) => { diagram?.import(JSON.stringify(json)); }) .catch(() => { throw new Error('Data Loading Error'); }); }, []); return ( <Diagram id="diagram" ref={diagramRef}> <Toolbox> <Group category="general" title="General" /> <Group category="containers" title="Containers" expanded={true} /> </Toolbox> </Diagram> ); }
import React, { useEffect, useRef } from 'react'; import Diagram, { Group, Toolbox } from 'devextreme-react/diagram'; import 'whatwg-fetch'; export default function App() { const diagramRef = useRef(null); useEffect(() => { const diagram = diagramRef?.current?.instance(); fetch('../../../../data/diagram-structure.json') .then((response) => response.json()) .then((json) => { diagram?.import(JSON.stringify(json)); }) .catch(() => { throw new Error('Data Loading Error'); }); }, []); return ( <Diagram id="diagram" ref={diagramRef} > <Toolbox> <Group category="general" title="General" /> <Group category="containers" title="Containers" expanded={true} /> </Toolbox> </Diagram> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
{ "page": { "width": 11910, "height": 8400, "pageColor": "white", "pageWidth": 8400, "pageHeight": 11910, "pageLandscape": true, "units": 0 }, "connectors": [], "shapes": [ { "key": "0", "locked": false, "zIndex": 0, "type": "verticalContainer", "text": "Development", "x": 720, "y": 720, "width": 10440.000000000002, "height": 7020, "childKeys": [ "1", "2", "4", "3" ] }, { "key": "1", "locked": false, "zIndex": 0, "type": "verticalContainer", "text": "ASP.NET Team", "x": 1080, "y": 1440, "width": 2160, "height": 5760, "childKeys": [ "5", "6" ] }, { "key": "2", "locked": false, "zIndex": 0, "type": "verticalContainer", "text": "Javascript Team", "x": 3600, "y": 1440, "width": 2160, "height": 5760, "childKeys": [ "7", "8" ] }, { "key": "3", "locked": false, "zIndex": 0, "type": "verticalContainer", "text": "WPF Team", "x": 6120, "y": 1440, "width": 2160, "height": 5760, "childKeys": [ "9", "10", "11" ] }, { "key": "4", "locked": false, "zIndex": 0, "type": "verticalContainer", "text": "WinForms Team", "x": 8640, "y": 1440, "width": 2160, "height": 5760, "childKeys": [ "12", "13" ] }, { "key": "5", "dataKey": "119", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Laurence\nLebihan", "x": 1440, "y": 2160, "width": 1440, "height": 1080 }, { "key": "6", "dataKey": "120", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Elizabeth\nLincoln", "x": 1440, "y": 3600, "width": 1440, "height": 1080 }, { "key": "7", "dataKey": "122", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Patricio\nSimpson", "x": 3960, "y": 2160, "width": 1440, "height": 1080 }, { "key": "8", "dataKey": "123", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Francisco\nChang", "x": 3960, "y": 3600, "width": 1440, "height": 1080 }, { "key": "9", "dataKey": "115", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Christina\nBerglund", "x": 6480, "y": 2160, "width": 1440, "height": 1080 }, { "key": "10", "dataKey": "116", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Hanna\nMoos", "x": 6480, "y": 3600, "width": 1440, "height": 1080 }, { "key": "11", "dataKey": "117", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Frederique\nCiteaux", "x": 6480, "y": 5040, "width": 1440, "height": 1080 }, { "key": "12", "dataKey": "112", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Ana\nTrujillo", "x": 9000, "y": 2160, "width": 1440, "height": 1080 }, { "key": "13", "dataKey": "113", "locked": false, "zIndex": 0, "type": "rectangle", "text": "Antonio\nMoreno", "x": 9000, "y": 3600, "width": 1440, "height": 1080 } ] }
<!DOCTYPE html> <html lang="en"> <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=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.5/css/dx-diagram.min.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="./bundle.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> <script src="bundles/vendor/react.vendor.js"></script> <script src="./bundle.js"></script> </body> </html>
#diagram { height: 725px; }