DevExtreme v26.1 is now available.

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

Your search did not match any results.

Angular Diagram - Background Images

The Diagram component provides a collection of built-in shapes. You can extend this collection with custom shapes.

An array of custom shape objects is accessible through the customShapes property. For each custom shape object, you can specify the type, background image, default size, text, connection points, and other settings. Note that shape images should be supplied as SVG files.

This demo shows how to populate the shape collection with custom shape types, and how to use custom shapes in the Diagram.

Backend API
<dx-diagram #diagram id="diagram"> <dxi-diagram-custom-shape category="hardware" type="internet" title="Internet" backgroundImageUrl="../../../../images/shapes/internet.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Internet" [allowEditText]="false" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="laptop" title="Laptop" backgroundImageUrl="../../../../images/shapes/laptop.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Laptop" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="mobile" title="Mobile" backgroundImageUrl="../../../../images/shapes/mobile.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Mobile" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="pc" title="PC" backgroundImageUrl="../../../../images/shapes/pc.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="PC" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="phone" title="Phone" backgroundImageUrl="../../../../images/shapes/phone.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Phone" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="printer" title="Printer" backgroundImageUrl="../../../../images/shapes/printer.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Printer" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="router" title="Router" backgroundImageUrl="../../../../images/shapes/router.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Router" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="scaner" title="Scaner" backgroundImageUrl="../../../../images/shapes/scaner.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Scaner" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="server" title="Server" backgroundImageUrl="../../../../images/shapes/server.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Server" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="switch" title="Switch" backgroundImageUrl="../../../../images/shapes/switch.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Switch" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxi-diagram-custom-shape category="hardware" type="wifi" title="Wi Fi Router" backgroundImageUrl="../../../../images/shapes/wifi.svg" [backgroundImageLeft]="0.15" [backgroundImageTop]="0" [backgroundImageWidth]="0.7" [backgroundImageHeight]="0.7" [defaultWidth]="0.75" [defaultHeight]="0.75" defaultText="Wi Fi" [allowEditText]="true" [textLeft]="0" [textTop]="0.7" [textWidth]="1" [textHeight]="0.3" > <dxi-diagram-connection-point [x]="0.5" [y]="0" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.9" [y]="0.5" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.5" [y]="1" ></dxi-diagram-connection-point> <dxi-diagram-connection-point [x]="0.1" [y]="0.5" ></dxi-diagram-connection-point> </dxi-diagram-custom-shape> <dxo-diagram-toolbox> <dxi-diagram-group category="hardware" title="Hardware"></dxi-diagram-group> </dxo-diagram-toolbox> </dx-diagram>
import { bootstrapApplication } from '@angular/platform-browser'; import { Component, ViewChild, enableProdMode, provideZoneChangeDetection } from '@angular/core'; import { HttpClient, provideHttpClient, withFetch } from '@angular/common/http'; import { DxDiagramModule, DxDiagramComponent } from 'devextreme-angular'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } @Component({ selector: 'demo-app', templateUrl: './app.component.html', styleUrls: ['./app.component.css'], preserveWhitespaces: true, imports: [ DxDiagramModule, ], }) export class AppComponent { @ViewChild(DxDiagramComponent, { static: false }) diagram: DxDiagramComponent; constructor(http: HttpClient) { http.get('../../../../data/diagram-hardware.json').subscribe({ next: (data) => { this.diagram.instance.import(JSON.stringify(data)); }, error: () => { throw new Error('Data Loading Error'); }, }); } } bootstrapApplication(AppComponent, { providers: [ provideZoneChangeDetection({ eventCoalescing: true, runCoalescing: true }), provideHttpClient(withFetch()), ], });
::ng-deep #diagram { height: 900px; }
<!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" /> </head> <body class="dx-viewport"> <div class="demo-container"> <demo-app>Loading...</demo-app> </div> <script src="https://cdn.jsdelivr.net/npm/zone.js@0.16.2/bundles/zone.umd.js"></script> <script src="./bundle.js" type="module"></script> </body> </html>
{ "page": { "width": 8400, "height": 11910, "pageColor": "white", "pageWidth": 8400, "pageHeight": 11910, "pageLandscape": false, "gridSize": 180, "showGrid": true, "snapToGrid": true, "units": 1 }, "connectors": [ { "key": "19", "locked": false, "zIndex": 0, "points": [ { "x": 4860, "y": 1620 }, { "x": 4860, "y": 2160 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "0", "beginConnectionPointIndex": 2, "endItemKey": "1", "endConnectionPointIndex": 0 }, { "key": "20", "locked": false, "zIndex": 0, "points": [ { "x": 4860, "y": 3240 }, { "x": 4860, "y": 5040 }, { "x": 3780, "y": 5040 }, { "x": 2700, "y": 5580 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "1", "beginConnectionPointIndex": 2, "endItemKey": "2", "endConnectionPointIndex": 0 }, { "key": "21", "locked": false, "zIndex": 0, "points": [ { "x": 4860, "y": 3240 }, { "x": 4860, "y": 5040 }, { "x": 7020, "y": 5040 }, { "x": 7020, "y": 5580 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "1", "beginConnectionPointIndex": 2, "endItemKey": "3", "endConnectionPointIndex": 0 }, { "key": "22", "locked": false, "zIndex": 0, "points": [ { "x": 2700, "y": 6660 }, { "x": 1980, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "2", "beginConnectionPointIndex": 2, "endItemKey": "5", "endConnectionPointIndex": 0 }, { "key": "23", "locked": false, "zIndex": 0, "points": [ { "x": 2700, "y": 6660 }, { "x": 3240, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "2", "beginConnectionPointIndex": 2, "endItemKey": "6", "endConnectionPointIndex": 0 }, { "key": "24", "locked": false, "zIndex": 0, "points": [ { "x": 2700, "y": 6660 }, { "x": 720, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "2", "beginConnectionPointIndex": 2, "endItemKey": "4", "endConnectionPointIndex": 0 }, { "key": "25", "locked": false, "zIndex": 0, "points": [ { "x": 2700, "y": 6660 }, { "x": 4500, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "2", "beginConnectionPointIndex": 2, "endItemKey": "7", "endConnectionPointIndex": 0 }, { "key": "27", "locked": false, "zIndex": 0, "points": [ { "x": 6300, "y": 8640 }, { "x": 6300, "y": 9000 }, { "x": 6300, "y": 9540 }, { "x": 6012, "y": 9540 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "9", "beginConnectionPointIndex": 2, "endItemKey": "10", "endConnectionPointIndex": 1 }, { "key": "28", "locked": false, "zIndex": 0, "points": [ { "x": 6300, "y": 8640 }, { "x": 6300, "y": 9000 }, { "x": 6300, "y": 10980 }, { "x": 6012, "y": 10980 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "9", "beginConnectionPointIndex": 2, "endItemKey": "11", "endConnectionPointIndex": 1 }, { "key": "29", "locked": false, "zIndex": 0, "points": [ { "x": 7020, "y": 6660 }, { "x": 6300, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "3", "beginConnectionPointIndex": 2, "endItemKey": "9", "endConnectionPointIndex": 0 }, { "key": "30", "locked": false, "zIndex": 0, "points": [ { "x": 4320, "y": 2700 }, { "x": 2592, "y": 2700 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "1", "beginConnectionPointIndex": 3, "endItemKey": "12", "endConnectionPointIndex": 1 }, { "key": "31", "locked": false, "zIndex": 0, "points": [ { "x": 5400, "y": 2700 }, { "x": 7128, "y": 2700 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "1", "beginConnectionPointIndex": 1, "endItemKey": "13", "endConnectionPointIndex": 3 }, { "key": "32", "locked": false, "zIndex": 0, "points": [ { "x": 2160, "y": 3240 }, { "x": 2160, "y": 3780 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "12", "beginConnectionPointIndex": 2, "endItemKey": "14", "endConnectionPointIndex": 0 }, { "key": "33", "locked": false, "zIndex": 0, "points": [ { "x": 2160, "y": 3240 }, { "x": 3600, "y": 3780 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "12", "beginConnectionPointIndex": 2, "endItemKey": "15", "endConnectionPointIndex": 0 }, { "key": "34", "locked": false, "zIndex": 0, "points": [ { "x": 7020, "y": 6660 }, { "x": 7740, "y": 7560 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "3", "beginConnectionPointIndex": 2, "endItemKey": "16", "endConnectionPointIndex": 0 }, { "key": "35", "locked": false, "zIndex": 0, "points": [ { "x": 7740, "y": 8640 }, { "x": 7740, "y": 9000 } ], "properties": { "lineOption": 0, "endLineEnding": 0 }, "beginItemKey": "16", "beginConnectionPointIndex": 2, "endItemKey": "17", "endConnectionPointIndex": 0 }, { "key": "36", "locked": false, "zIndex": 0, "points": [ { "x": 2160, "y": 3240 }, { "x": 720, "y": 3780 } ], "properties": { "endLineEnding": 0 }, "beginItemKey": "12", "beginConnectionPointIndex": 2, "endItemKey": "18", "endConnectionPointIndex": 0 } ], "shapes": [ { "key": "0", "locked": false, "zIndex": 0, "type": "internet", "text": "Internet", "x": 4320, "y": 540, "width": 1080, "height": 1080 }, { "key": "1", "locked": false, "zIndex": 0, "type": "router", "text": "Router", "x": 4320, "y": 2160, "width": 1080, "height": 1080 }, { "key": "2", "locked": false, "zIndex": 0, "type": "switch", "text": "Switch", "x": 2160, "y": 5580, "width": 1080, "height": 1080 }, { "key": "3", "locked": false, "zIndex": 0, "type": "switch", "text": "Switch", "x": 6480, "y": 5580, "width": 1080, "height": 1080 }, { "key": "4", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 180, "y": 7560, "width": 1080, "height": 1080 }, { "key": "5", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 1440, "y": 7560, "width": 1080, "height": 1080 }, { "key": "6", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 2700, "y": 7560, "width": 1080, "height": 1080 }, { "key": "7", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 3960, "y": 7560, "width": 1080, "height": 1080 }, { "key": "9", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 5760, "y": 7560, "width": 1080, "height": 1080 }, { "key": "10", "locked": false, "zIndex": 0, "type": "printer", "text": "Printer", "x": 5040, "y": 9000, "width": 1080, "height": 1080 }, { "key": "11", "locked": false, "zIndex": 0, "type": "scaner", "text": "Scaner", "x": 5040, "y": 10440, "width": 1080, "height": 1080 }, { "key": "12", "locked": false, "zIndex": 0, "type": "wifi", "text": "Wi Fi", "x": 1620, "y": 2160, "width": 1080, "height": 1080 }, { "key": "13", "locked": false, "zIndex": 0, "type": "server", "text": "Server", "x": 7020, "y": 2160, "width": 1080, "height": 1080 }, { "key": "14", "locked": false, "zIndex": 0, "type": "laptop", "text": "Laptop", "x": 1620, "y": 3780, "width": 1080, "height": 1080 }, { "key": "15", "locked": false, "zIndex": 0, "type": "mobile", "text": "Mobile", "x": 3060, "y": 3780, "width": 1080, "height": 1080 }, { "key": "16", "locked": false, "zIndex": 0, "type": "pc", "text": "PC", "x": 7200, "y": 7560, "width": 1080, "height": 1080 }, { "key": "17", "locked": false, "zIndex": 0, "type": "phone", "text": "Phone", "x": 7200, "y": 9000, "width": 1080, "height": 1080 }, { "key": "18", "locked": false, "zIndex": 0, "type": "laptop", "text": "Laptop", "x": 180, "y": 3780, "width": 1080, "height": 1080 } ] }