Background Images
Documentation
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.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
$(function() {
var diagram = $("#diagram").dxDiagram({
customShapes: [
{
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: true,
textLeft: 0,
textTop: 0.7,
textWidth: 1,
textHeight: 0.3,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
},
{
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,
connectionPoints: [
{ x: 0.5, y: 0 },
{ x: 0.9, y: 0.5 },
{ x: 0.5, y: 1 },
{ x: 0.1, y: 0.5 }
]
}
],
toolbox: {
groups: [{ category: "hardware", title: "Hardware" }]
}
}).dxDiagram("instance");
$.ajax({
url: "../../../../data/diagram-hardware.json",
dataType: "text",
success: function(data) {
diagram.import(data);
}
});
});
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<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" />
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script>
<script src="https://cdn3.devexpress.com/jslib/21.1.6/js/dx-diagram.min.js"></script>
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.1.6/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.1.6/css/dx.light.css" />
<link rel="stylesheet" href="https://cdn3.devexpress.com/jslib/21.1.6/css/dx-diagram.css" />
<script src="https://cdn3.devexpress.com/jslib/21.1.6/js/dx.all.js"></script>
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="index.js"></script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="diagram">
</div>
</div>
</body>
</html>
#diagram {
height: 900px;
}
{
"page": {
"width": 8391,
"height": 11906,
"pageColor": "white",
"pageWidth": 8391,
"pageHeight": 11906,
"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": 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": 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
}
]
}