DevExtreme v24.1 is now available.

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

Your search did not match any results.

Advanced Data Binding

The Diagram component accepts functions as expression property values. It allows you to implement custom logic when you bind a diagram to a data source.

In this demo, the nodes and edges collections are bound to a data source. Custom functions are used to get different shape types and font styles for items based on additional data source information.

The autoLayout property specifies an auto-layout algorithm type and orientation that the component uses to build diagrams.

Backend API
import React from 'react'; import Diagram, { Nodes, AutoLayout, Edges, Toolbox, Group, } from 'devextreme-react/diagram'; import ArrayStore from 'devextreme/data/array_store'; import service from './data.ts'; const orgItemsDataSource = new ArrayStore({ key: 'id', data: service.getOrgItems(), }); const orgLinksDataSource = new ArrayStore({ key: 'id', data: service.getOrgLinks(), }); function itemTypeExpr(obj: { type: string; }, value: string) { if (value) { obj.type = (value === 'rectangle') ? undefined : 'group'; } else { return obj.type === 'group' ? 'ellipse' : 'rectangle'; } return null; } function itemWidthExpr(obj: { width: number; type: string; }, value) { if (value) { obj.width = value; } else { return obj.width || (obj.type === 'group' && 1.5) || 1; } return null; } function itemHeightExpr(obj: { height: number; type: string; }, value) { if (value) { obj.height = value; } else { return obj.height || (obj.type === 'group' && 1) || 0.75; } return null; } function itemTextStyleExpr(obj: { level: string; }) { if (obj.level === 'senior') { return { 'font-weight': 'bold', 'text-decoration': 'underline' }; } return {}; } function itemStyleExpr(obj: { type: string; }) { const style: React.CSSProperties = { stroke: '#444444' }; if (obj.type === 'group') { style.fill = '#f3f3f3'; } return style; } function linkStyleExpr() { return { stroke: '#444444' }; } function linkFromLineEndExpr() { return 'none'; } function linkToLineEndExpr() { return 'none'; } export default function App() { return ( <Diagram id="diagram"> <Nodes dataSource={orgItemsDataSource} typeExpr={itemTypeExpr} textExpr="name" widthExpr={itemWidthExpr} heightExpr={itemHeightExpr} textStyleExpr={itemTextStyleExpr} styleExpr={itemStyleExpr}> <AutoLayout type="tree" orientation="horizontal" /> </Nodes> <Edges dataSource={orgLinksDataSource} styleExpr={linkStyleExpr} fromLineEndExpr={linkFromLineEndExpr} toLineEndExpr={linkToLineEndExpr} /> <Toolbox> <Group category="general" title="General" /> </Toolbox> </Diagram> ); }
import React from 'react'; import Diagram, { Nodes, AutoLayout, Edges, Toolbox, Group, } from 'devextreme-react/diagram'; import ArrayStore from 'devextreme/data/array_store'; import service from './data.js'; const orgItemsDataSource = new ArrayStore({ key: 'id', data: service.getOrgItems(), }); const orgLinksDataSource = new ArrayStore({ key: 'id', data: service.getOrgLinks(), }); function itemTypeExpr(obj, value) { if (value) { obj.type = value === 'rectangle' ? undefined : 'group'; } else { return obj.type === 'group' ? 'ellipse' : 'rectangle'; } return null; } function itemWidthExpr(obj, value) { if (value) { obj.width = value; } else { return obj.width || (obj.type === 'group' && 1.5) || 1; } return null; } function itemHeightExpr(obj, value) { if (value) { obj.height = value; } else { return obj.height || (obj.type === 'group' && 1) || 0.75; } return null; } function itemTextStyleExpr(obj) { if (obj.level === 'senior') { return { 'font-weight': 'bold', 'text-decoration': 'underline' }; } return {}; } function itemStyleExpr(obj) { const style = { stroke: '#444444' }; if (obj.type === 'group') { style.fill = '#f3f3f3'; } return style; } function linkStyleExpr() { return { stroke: '#444444' }; } function linkFromLineEndExpr() { return 'none'; } function linkToLineEndExpr() { return 'none'; } export default function App() { return ( <Diagram id="diagram"> <Nodes dataSource={orgItemsDataSource} typeExpr={itemTypeExpr} textExpr="name" widthExpr={itemWidthExpr} heightExpr={itemHeightExpr} textStyleExpr={itemTextStyleExpr} styleExpr={itemStyleExpr} > <AutoLayout type="tree" orientation="horizontal" /> </Nodes> <Edges dataSource={orgLinksDataSource} styleExpr={linkStyleExpr} fromLineEndExpr={linkFromLineEndExpr} toLineEndExpr={linkToLineEndExpr} /> <Toolbox> <Group category="general" title="General" /> </Toolbox> </Diagram> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
const orgItems = [ { id: '106', name: 'Development', type: 'group', }, { id: '107', name: 'WinForms\nTeam', type: 'group', }, { id: '108', name: 'WPF\nTeam', type: 'group', }, { id: '109', name: 'Javascript\nTeam', type: 'group', }, { id: '110', name: 'ASP.NET\nTeam', type: 'group', }, { id: '112', name: 'Ana\nTrujillo', level: 'senior', }, { id: '113', name: 'Antonio\nMoreno', }, { id: '115', name: 'Christina\nBerglund', }, { id: '116', name: 'Hanna\nMoos', }, { id: '119', name: 'Laurence\nLebihan', }, { id: '120', name: 'Elizabeth\nLincoln', level: 'senior', }, { id: '122', name: 'Patricio\nSimpson', level: 'senior', }, { id: '123', name: 'Francisco\nChang', }, ]; const orgLinks = [ { id: '124', from: '106', to: '108', }, { id: '125', from: '106', to: '109', }, { id: '126', from: '106', to: '107', }, { id: '127', from: '106', to: '110', }, { id: '129', from: '110', to: '112', }, { id: '130', from: '110', to: '113', }, { id: '132', from: '107', to: '115', }, { id: '133', from: '107', to: '116', }, { id: '136', from: '108', to: '119', }, { id: '137', from: '108', to: '120', }, { id: '139', from: '109', to: '122', }, { id: '140', from: '109', to: '123', }, ]; export default { getOrgItems() { return orgItems; }, getOrgLinks() { return orgLinks; }, };
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, '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/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', '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', '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@24.1.3/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.3/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.8/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', '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', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // 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.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
const orgItems = [ { id: '106', name: 'Development', type: 'group', }, { id: '107', name: 'WinForms\nTeam', type: 'group', }, { id: '108', name: 'WPF\nTeam', type: 'group', }, { id: '109', name: 'Javascript\nTeam', type: 'group', }, { id: '110', name: 'ASP.NET\nTeam', type: 'group', }, { id: '112', name: 'Ana\nTrujillo', level: 'senior', }, { id: '113', name: 'Antonio\nMoreno', }, { id: '115', name: 'Christina\nBerglund', }, { id: '116', name: 'Hanna\nMoos', }, { id: '119', name: 'Laurence\nLebihan', }, { id: '120', name: 'Elizabeth\nLincoln', level: 'senior', }, { id: '122', name: 'Patricio\nSimpson', level: 'senior', }, { id: '123', name: 'Francisco\nChang', }, ]; const orgLinks = [ { id: '124', from: '106', to: '108', }, { id: '125', from: '106', to: '109', }, { id: '126', from: '106', to: '107', }, { id: '127', from: '106', to: '110', }, { id: '129', from: '110', to: '112', }, { id: '130', from: '110', to: '113', }, { id: '132', from: '107', to: '115', }, { id: '133', from: '107', to: '116', }, { id: '136', from: '108', to: '119', }, { id: '137', from: '108', to: '120', }, { id: '139', from: '109', to: '122', }, { id: '140', from: '109', to: '123', }, ]; export default { getOrgItems() { return orgItems; }, getOrgLinks() { return orgLinks; }, };
<!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/24.1.3/css/dx-diagram.min.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.3/css/dx.light.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.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
#diagram { height: 900px; }