DevExtreme v23.1 is now available.

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

Your search did not match any results.
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
Copy to CodeSandBox
Apply
Reset
import React from 'react'; import Diagram, { Group, Toolbox } from 'devextreme-react/diagram'; import 'whatwg-fetch'; class App extends React.Component { constructor(props) { super(props); this.diagramRef = React.createRef(); } componentDidMount() { const diagram = this.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'); }); } render() { return ( <Diagram id="diagram" ref={this.diagramRef}> <Toolbox> <Group category="general" title="General" /> <Group category="containers" title="Containers" expanded={true} /> </Toolbox> </Diagram> ); } } 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/23.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.1.5/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.6.12/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: 725px; }
window.config = { transpiler: 'plugin-babel', meta: { 'devextreme/localization.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'whatwg-fetch': 'npm:whatwg-fetch@2.0.4/fetch.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.1.5/cjs', 'devextreme-react': 'npm:devextreme-react@23.1.5', 'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.1/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.48/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11', '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', // 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', // Prettier 'prettier/standalone': 'npm:prettier@2.8.4/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.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', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.11/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
{ "page": { "width": 11906, "height": 8391, "pageColor": "white", "pageWidth": 8391, "pageHeight": 11906, "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 } ] }