Automatic layout in EJ2 JavaScript Diagram control
12 Jul 202324 minutes to read
Diagram provides support to auto-arrange the nodes in the diagram area that is referred as Layout
. It includes the following layout modes:
Layout modes
- Hierarchical layout
- Organization chart
- Radial tree
- Symmetric layout
- Mind Map layout
- Complex hierarchical tree layout
Hierarchical layout
The hierarchical tree layout arranges nodes in a tree-like structure, where the nodes in the hierarchical layout may have multiple parents. There is no need to specify the layout root. To arrange the nodes in a hierarchical structure, specify the layout type
as hierarchical tree. The following example shows how to arrange the nodes in a hierarchical structure.
Note: If you want to use hierarchical tree layout in diagram, you need to inject HierarchicalTree in the diagram.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [{
Name: "Steve-Ceo"
},
{
Name: "Kevin-Manager",
ReportingPerson: "Steve-Ceo"
},
{
Name: "Peter-Manager",
ReportingPerson: "Steve-Ceo"
},
{
Name: "John- Manager",
ReportingPerson: "Peter-Manager"
},
{
Name: "Mary-CSE ",
ReportingPerson: "Peter-Manager"
},
{
Name: "Jim-CSE ",
ReportingPerson: "Kevin-Manager"
},
{
Name: "Martin-CSE",
ReportingPerson: "Kevin-Manager"
}
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%',
height: '650px',
//Uses layout to auto-arrange nodes on the diagram page
layout: {
//Sets layout type
type: 'HierarchicalTree'
},//Configures data source for diagram
dataSourceSettings: {
id: 'Name',
parentId: 'ReportingPerson',
dataManager: items
},//Sets the default properties for nodes
getNodeDefaults: (obj) => {
obj.shape = {
type: 'Text',
content: (obj.data.Name)
};
obj.style = {
fill: 'None',
strokeColor: 'none',
strokeWidth: 2,
bold: true,
color: 'white'
};
obj.borderColor = 'white';
obj.width = 100;
obj.height = 40;
obj.backgroundColor = '#6BA5D7';
obj.borderWidth = 1;
(obj.shape ).margin = {
left: 5,
right: 5,
top: 5,
bottom: 5
};
return obj;
},//Sets the default properties for and connectors
getConnectorDefaults: (connector, diagram) => {
connector.style = {
strokeColor: '#6BA5D7',
strokeWidth: 2
};
connector.targetDecorator.style.fill = '#6BA5D7';
connector.targetDecorator.style.strokeColor = '#6BA5D7';
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Radial tree layout
The radial tree layout arranges nodes on a virtual concentric circle around a root node. Sub-trees formed by the branching of child nodes are located radially around the child nodes. This arrangement result in an ever-expanding concentric arrangement with radial proximity to the root node indicating the node level in the hierarchy. The layout root
property can be used to define the root node of the layout. When no root node is set, the algorithm automatically considers one of the diagram nodes as the root node.
To arrange nodes in a radial tree structure, set the type
of the layout as RadialTree
. The following code illustrates how to arrange the nodes in a radial tree structure.
Note: If you want to use radial tree layout in diagram, you need to inject DataBinding and RadialTree in the diagram.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{
"Id": "parent", "Name": "Maria Anders", "Designation": "Managing Director",
"ImageUrl": "../content/images/radialtree/Clayton.png", "IsExpand": "true", "RatingColor": "#C34444"
},
{
"Id": 1, "Name": "Ana Trujillo", "Designation": "Project Manager",
"ImageUrl": "../content/images/radialtree/Thomas.PNG", "IsExpand": "false",
"RatingColor": "#68C2DE", "ReportingPerson": "parent"
},
{
"Id": 2, "Name": "Lino Rodri", "Designation": "Project Manager",
"ImageUrl": "../content/images/radialtree/Robin.PNG", "IsExpand": "true",
"RatingColor": "#68C2DE", "ReportingPerson": "parent"
},
{
"Id": 3, "Name": "Philip Cramer", "Designation": "Project Manager",
"ImageUrl": "../content/images/radialtree/Robin.PNG", "IsExpand": "true",
"RatingColor": "#68C2DE", "ReportingPerson": "parent"
},
{
"Id": 4, "Name": "Pedro Afonso", "Designation": "Project Manager",
"ImageUrl": "../content/images/radialtree/Paul.png", "IsExpand": "true",
"RatingColor": "#68C2DE", "ReportingPerson": 1
},
{
"Id": 5, "Name": "Anto Moreno", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/image53.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 1
},
{
"Id": 6, "Name": "Elizabeth Roel", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Maria.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 2
},
{
"Id": 7, "Name": "Aria Cruz", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Jenny.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 3
},
{
"Id": 8, "Name": "Eduardo Roel", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/image55.png", "IsExpand": "true",
"RatingColor": "#93B85A", "ReportingPerson": 1
},
{
"Id": 9, "Name": "Howard Snyd", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Jenny.png", "IsExpand": "false",
"RatingColor": "#68C2DE", "ReportingPerson": 1
},
{
"Id": 10, "Name": "Daniel Tonini", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Thomas.png", "IsExpand": "true",
"RatingColor": "#93B85A", "ReportingPerson": 1
},
{
"Id": 11, "Name": "Nardo Batista", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Maria.PNG", "IsExpand": "true",
"RatingColor": "#68C2DE", "ReportingPerson": 1
},
{
"Id": 12, "Name": "Michael Holz", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Thomas.PNG", "IsExpand": "true",
"RatingColor": "#68C2DE", "ReportingPerson": 1
},
{
"Id": 13, "Name": "Kloss Perrier", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Clayton.png", "IsExpand": "None",
"RatingColor": "#93B85A", "ReportingPerson": 1
},
{
"Id": 14, "Name": "Liz Nixon", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Jenny.png", "IsExpand": "false",
"RatingColor": "#68C2DE", "ReportingPerson": 1
},
{
"Id": 15, "Name": "Paul Henriot", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Thomas.png", "IsExpand": "false",
"RatingColor": "#D46E89", "ReportingPerson": 1
},
{
"Id": 16, "Name": "Paula Parente", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/John.png", "IsExpand": "None",
"RatingColor": "#EBB92E", "ReportingPerson": 1
},
{
"Id": 17, "Name": "Matti Kenna", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Jenny.png", "IsExpand": "None",
"RatingColor": "#93B85A", "ReportingPerson": 3
},
{
"Id": 18, "Name": "Laura Callahan", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Robin.png", "IsExpand": "false",
"RatingColor": "#D46E89", "ReportingPerson": 3
},
{
"Id": 19, "Name": "Simon Roel", "Designation": "Project Lead",
"ImageUrl": "../content/images/radialtree/Clayton.png", "IsExpand": "true",
"RatingColor": "#93B85A", "ReportingPerson": 3
},
{
"Id": 20, "Name": "Thomas Hardy", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image57.png", "IsExpand": "false",
"RatingColor": "#68C2DE", "ReportingPerson": 3
},
{
"Id": 21, "Name": "Martín Kloss", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Robin.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 3
},
{
"Id": 22, "Name": "Maria Larsson", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image51.png", "IsExpand": "false",
"RatingColor": "#EBB92E", "ReportingPerson": 3
},
{
"Id": 23, "Name": "Diego Roel", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image55.png", "IsExpand": "false",
"RatingColor": "#D46E89", "ReportingPerson": 3
},
{
"Id": 24, "Name": "José Pedro ", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Thomas.png", "IsExpand": "true",
"RatingColor": "#D46E89", "ReportingPerson": 3
},
{
"Id": 25, "Name": "Manu Pereira", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image56.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 3
},
{
"Id": 26, "Name": "Annette Roel", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image55.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 2
},
{
"Id": 27, "Name": "Catherine Kaff", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image57.png", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 2
},
{
"Id": 28, "Name": "Lúcia Carvalho", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Robin.PNG", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 2
},
{
"Id": 29, "Name": "Alej Camino", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Thomas.PNG", "IsExpand": "false",
"RatingColor": "#93B85A", "ReportingPerson": 2
},
{
"Id": 30, "Name": "Liu Wong", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image57.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 2
},
{
"Id": 31, "Name": "Karin Josephs", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image55.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 2
},
{
"Id": 32, "Name": "Ruby Anabela ", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Thomas.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 2
},
{
"Id": 33, "Name": "Pirkko King", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/Robin.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 2
},
{
"Id": 34, "Name": "Karl Jablonski", "Designation": "Senior S/w Engg",
"ImageUrl": "../content/images/radialtree/image53.png", "IsExpand": "None",
"RatingColor": "#D46E89", "ReportingPerson": 2
},
];
var items = new ej.data.DataManager(data , new ej.data.Query().take(5));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '590px',
snapSettings: { constraints: 0 },
layout: {
type: 'RadialTree', horizontalSpacing: 30, verticalSpacing: 30, root: 'parent'
},
dataSourceSettings: {
id: 'Id', parentId: 'ReportingPerson', dataManager: items
},
getNodeDefaults: (obj, diagram) => {
obj.height = 15;
obj.width = 15;
obj.backgroundColor = 'lightgrey';
obj.style = { fill: 'transparent', strokeWidth: 2 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.targetDecorator.shape = 'None';
connector.type = 'Straight';
return connector;
},
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Organizational Chart
An organizational chart is a diagram that displays the structure of an organization and relationships. To create an organizational chart, the type
of layout should be set as an OrganizationalChart
.
The following code example illustrates how to create an organizational chart.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{ Id: "parent", Role: "Project Management" },
{ Id: 1, Role: "R&D Team", Team: "parent" },
{ Id: 3, Role: "Philosophy", Team: "1" },
{ Id: 4, Role: "Organization", Team: "1" },
{ Id: 5, Role: "Technology", Team: "1" },
{ Id: 7, Role: "Funding", Team: "1" },
{ Id: 8, Role: "Resource Allocation", Team: "1" },
{ Id: 9, Role: "Targeting", Team: "1" },
{ Id: 11, Role: "Evaluation", Team: "1" },
{ Id: 156, Role: "HR Team", Team: "parent" },
{ Id: 13, Role: "Recruitment", Team: "156" },
{ Id: 113, Role: "Training", Team: "12" },
{ Id: 112, Role: "Employee Relation", Team: "156" },
{ Id: 14, Role: "Record Keeping", Team: "12" },
{ Id: 15, Role: "Compensations & Benefits", Team: "12" },
{ Id: 16, Role: "Compliances", Team: "12" },
{ Id: 17, Role: "Production & Sales Team", Team: "parent" },
{ Id: 119, Role: "Design", Team: "17" },
{ Id: 19, Role: "Operation", Team: "17" },
{ Id: 20, Role: "Support", Team: "17" },
{ Id: 21, Role: "Quality Assurance", Team: "17" },
{ Id: 23, Role: "Customer Interaction", Team: "17" },
{ Id: 24, Role: "Support and Maintenance", Team: "17" },
{ Id: 25, Role: "Task Coordination", Team: "17" }
];
var items = new ej.data.DataManager(data , new ej.data.Query().take(5));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'OrganizationalChart' },
dataSourceSettings: { id: 'Id', parentId: 'Team', dataManager: items },
getNodeDefaults: (obj) => {
obj.shape = { type: 'Text', content: (obj.data).Role };
obj.style = { fill: 'None', strokeColor: 'none',strokeWidth: 2,bold:true,color:'white' };
obj.borderColor = 'black';
obj.backgroundColor = 'darkcyan';
obj.width = 75;
obj.height = 40;
obj.borderWidth = 1;
(obj.shape).margin = { left: 5, right: 5, top: 5, bottom: 5 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Organizational chart layout starts parsing from root and iterate through all its child elements. The getLayoutInfo
method provides necessary information of a node’s children and the way to arrange (direction, orientation, offsets, etc.) them. The arrangements can be customized by overriding this function as explained.
GetLayoutInfo
Set chart orientations, chart types, and offset to be left between parent and child nodes by overriding the method, diagram.layout.getLayoutInfo
. The getLayoutInfo
method is called to configure every subtree of the organizational chart. It takes the following arguments.
* node: Parent node to that options are to be customized.
* options: Object to set the customizable properties.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{
'Id': 'parent', 'Name': 'Maria Anders', 'Designation': 'Managing Director',
'IsExpand': 'true', 'RatingColor': '#C34444'
},
{
'Id': 1, 'Name': 'Ana Trujillo', 'Designation': 'Project Manager',
'IsExpand': 'false',
'RatingColor': '#68C2DE', 'ReportingPerson': 'parent'
},
{
'Id': 2, 'Name': 'Anto Moreno', 'Designation': 'Project Lead',
'IsExpand': 'false',
'RatingColor': '#93B85A', 'ReportingPerson': 'parent'
}
];
var items = new ej.data.DataManager(data , new ej.data.Query().take(7));
diagram = new ej.diagrams.Diagram({
snapSettings: { constraints: 0 },
layout: {
type: 'OrganizationalChart', margin: { top: 20 },
getLayoutInfo: (node, option) => {
if (!option.hasSubTree) {
option.orientation = 'Vertical';
option.type = 'Alternate';
}
}
},
dataSourceSettings: {
id: 'Id', parentId: 'ReportingPerson', dataManager: items
},
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
The following table illustrates the properties that “options” argument takes.
Property | Description | Default Value |
---|---|---|
options.assistants | By default, the collection is empty. When any of the child nodes have to be set asAssistant, you can remove from children collection and have to insert into assistants collection. | Empty array |
options.orientation | Gets or sets the organizational chart orientation. | SubTreeOrientation.Vertical |
options.type | Gets or sets the chart organizational chart type. | For horizontal chart orientation:SubTreeAlignments.Center and for vertical chart orientation:SubTreeAlignments.Alternate |
options.offset | Offset is the horizontal space to be left between parent and child nodes. | 20 pixels applicable only for vertical chart orientations. |
options.hasSubTree | Gets whether the node contains subtrees. | Boolean |
options.level | Gets the depth of the node from layout root. | Number |
options.enableRouting | By default, connections are routed based on the chart type and orientations. This property gets or sets whether default routing is to be enabled or disabled. | true |
options.rows | Sets the number of rows on which the child nodes will be arranged. Applicable only for balanced type horizontal tree. | Number |
The following table illustrates the different chart orientations and chart types.
Orientation | Type | Description | Example |
---|---|---|---|
Horizontal | Left | Arranges the child nodes horizontally at the left side of the parent. | |
Right | Arranges the child nodes horizontally at the right side of the parent. | ||
Center | Arranges the children like standard tree layout orientation. | ||
Balanced | Arranges the leaf level child nodes in multiple rows. | ||
Vertical | Left | Arranges the children vertically at the left side of the parent. | |
Right | Arranges the children vertically at the right side of the parent. | ||
Alternate | Arranges the children vertically at both left and right sides of the parent. |
The following code example illustrates how to set the vertical right arrangement to the leaf level trees.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [{ Id: "parent", Role: "Board" },
{ Id: "1", Role: "General Manager", Manager: "parent" },
{ Id: "2", Role: "Human Resource Manager", Manager: "1" },
{ Id: "3", Role: "Trainers", Manager: "2" },
{ Id: "4", Role: "Recruiting Team", Manager: "2" },
{ Id: "5", Role: "Finance Asst. Manager", Manager: "2" },
{ Id: "6", Role: "Design Manager", Manager: "1" },
{ Id: "7", Role: "Design Supervisor", Manager: "6" },
{ Id: "8", Role: "Development Supervisor", Manager: "6" },
{ Id: "9", Role: "Drafting Supervisor", Manager: "6" },
{ Id: "10", Role: "Marketing Manager", Manager: "1" },
{ Id: "11", Role: "Oversea sales Manager", Manager: "10" },
{ Id: "12", Role: "Petroleum Manager", Manager: "10" },
{ Id: "13", Role: "Service Dept. Manager", Manager: "10" },
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '530px',
snapSettings: { constraints: 0 },
layout: {
type: 'OrganizationalChar',
getLayoutInfo: (node, options) => {
if (node.data['Role'] === 'General Manager') {
options.assistants.push(options.children[0]);
options.children.splice(0, 1);
}
if (!options.hasSubTree) {
options.type = 'Right';
options.orientation = 'Vertical';
}
}
},
dataSourceSettings: {
id: 'Id', parentId: 'Manager', dataManager: items
},
getNodeDefaults: (obj, diagram) => {
obj.width = 150;
obj.height = 50;
obj.style.fill = 'darkcyan';
obj.annotations = [{ content: obj.data['Role'], style: { color: 'white' } }];
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.targetDecorator.shape = 'None';
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Assistant
Assistants are child item that have a different relationship with the parent node. They are laid out in a dedicated part of the tree. A node can be specified as an assistant of its parent by adding it to the assistants
property of the argument “options”.
The following code example illustrates how to add assistants to layout.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [{ Id: 1, Role: "General Manager" },
{ Id: 2, Role: "Assistant Manager", Team: 1 },
{ Id: 3, Role: "Human Resource Manager", Team: 1 },
{ Id: 4, Role: "Design Manager", Team: 1 },
{ Id: 5, Role: "Operation Manager", Team: 1 },
{ Id: 6, Role: "Marketing Manager", Team: 1 }
];
var items= new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '530px',
snapSettings: { constraints: 0 },
layout: {
type: 'OrganizationalChart',
getLayoutInfo: (node, options) => {
if (node.data['Role'] === 'General Manager') {
options.assistants.push(options.children[0]);
options.children.splice(0, 1);
}
if (!options.hasSubTree) {
options.type = 'Center';
options.orientation = 'Horizontal';
}
}
},
dataSourceSettings: {
id: 'Id', parentId: 'Team', dataManager: items
},
getNodeDefaults: (obj, diagram) => {
obj.width = 150;
obj.height = 50;
obj.style.fill = 'darkcyan';
obj.annotations = [{ content: obj.data['Role'], style: { color: 'white' } }];
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.targetDecorator.shape = 'None';
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Symmetric layout
The symmetric layout has been formed using nodes position by closer together or pushing them further apart. This is repeated iteratively until the system comes to an equilibrium state.
The layout’s springLength
defined as how long edges should be, ideally. This will be the resting length for the springs. Edge attraction and vertex repulsion forces to be defined by using layout’s springFactor
, the more sibling nodes repel each other. The relative positions do not change any more from one iteration to the next. The number of iterations can be specified by using layout’s maxIteration
.
The following code illustrates how to arrange the nodes in a radial tree structure.
Note: If you want to use symmetric layout in diagram, you need to inject SymmetricLayout in the diagram.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var nodes = [];
var connectors = [];
function ConnectNodes(parentNode, childNode) {
var connector = {
id: parentNode.id + childNode.id,
sourceID: parentNode.id,
targetID: childNode.id,
targetDecorator: { shape: 'None' }
}
return connector;
}
function GetRectangle(name) {
var shape = { type: 'Basic', shape: 'Ellipse' };
var node = { id: name, height: 25, width: 25, borderColor: '#5e5e5e', borderWidth: 1, style: { fill: '#ff6329' }, shape: shape };
return node;
}
function populateNodes() {
var parentRect = GetRectangle("p");
nodes.push(parentRect);
for (var i = 0; i < 2; i++) {
var childRect_i = GetRectangle("c" + i);
nodes.push(childRect_i);
for (var j = 0; j < 2; j++) {
var childRect_j = GetRectangle("c" + i + j);
nodes.push(childRect_j);
for (var k = 0; k < 6; k++) {
var childRect_k = GetRectangle("c" + i + j + k);
nodes.push(childRect_k);
connectors.push(ConnectNodes(childRect_j, childRect_k));
}
connectors.push(ConnectNodes(childRect_i, childRect_j));
}
connectors.push(ConnectNodes(parentRect, childRect_i));
}
return nodes;
}
populateNodes();
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'SymmetricalLayout', springLength: 80, springFactor: 0.8, maxIteration: 500, margin: { left: 20, top: 20 } },
nodes: nodes, connectors: connectors,
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Mind Map layout
A mind map is a diagram that displays the nodes as a spider diagram organizes information around a central concept. To create mind map, the type
of layout should be set as MindMap
.
Tree Orientation in layout
An Orientation
of a MindMapTreeLayout
is used to arrange the tree layout according to a specific direction. By default, the orientation is set to Horizontal. The following table outlines the various orientation types available:
Orientation Type | Description |
Horizontal | Aligns the tree layout from left to right |
Vertical | Aligns the tree layout from top to bottom |
The following code example illustrates how to create an mindmap layout.
NOTE
If you want to use mind map layout in diagram, you need to inject MindMap in the diagram.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var nodes = [];
var connectors = [];
function ConnectNodes(parentNode, childNode) {
var connector = {
id: parentNode.id + childNode.id,
sourceID: parentNode.id,
targetID: childNode.id,
targetDecorator: { shape: 'None' }
}
return connector;
}
function GetRectangle(name) {
var shape = { type: 'Basic', shape: 'Ellipse' };
var node = { id: name, height: 25, width: 25, borderColor: '#5e5e5e', borderWidth: 1, style: { fill: '#ff6329' }, shape: shape };
return node;
}
function populateNodes() {
var parentRect = GetRectangle("p");
nodes.push(parentRect);
for (var i = 0; i < 2; i++) {
var childRect_i = GetRectangle("c" + i);
nodes.push(childRect_i);
for (var j = 0; j < 2; j++) {
var childRect_j = GetRectangle("c" + i + j);
nodes.push(childRect_j);
for (var k = 0; k < 6; k++) {
var childRect_k = GetRectangle("c" + i + j + k);
nodes.push(childRect_k);
connectors.push(ConnectNodes(childRect_j, childRect_k));
}
connectors.push(ConnectNodes(childRect_i, childRect_j));
}
connectors.push(ConnectNodes(parentRect, childRect_i));
}
return nodes;
}
populateNodes();
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'SymmetricalLayout', springLength: 80, springFactor: 0.8, maxIteration: 500, margin: { left: 20, top: 20 } },
nodes: nodes, connectors: connectors,
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Complex hierarchical tree
Complex hierarchical tree layout is the extended version of the hierarchical tree layout. The child had been two or more parents. To create a complex hierarchical tree, the type
of layout should be set as ComplexHierarchicalTree
.
Note: If you want to use Complex hierarchical layout in diagram, you need to inject ComplexHierarchicalTree in the diagram.
The following code example illustrates how to create a complex hierarchical tree.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var nodes = [];
var connectors = [];
function ConnectNodes(parentNode, childNode) {
var connector = {
id: parentNode.id + childNode.id,
sourceID: parentNode.id,
targetID: childNode.id,
targetDecorator: { shape: 'None' }
}
return connector;
}
function GetRectangle(name) {
var shape = { type: 'Basic', shape: 'Ellipse' };
var node = { id: name, height: 25, width: 25, borderColor: '#5e5e5e', borderWidth: 1, style: { fill: '#ff6329' }, shape: shape };
return node;
}
function populateNodes() {
var parentRect = GetRectangle("p");
nodes.push(parentRect);
for (var i = 0; i < 2; i++) {
var childRect_i = GetRectangle("c" + i);
nodes.push(childRect_i);
for (var j = 0; j < 2; j++) {
var childRect_j = GetRectangle("c" + i + j);
nodes.push(childRect_j);
for (var k = 0; k < 6; k++) {
var childRect_k = GetRectangle("c" + i + j + k);
nodes.push(childRect_k);
connectors.push(ConnectNodes(childRect_j, childRect_k));
}
connectors.push(ConnectNodes(childRect_i, childRect_j));
}
connectors.push(ConnectNodes(parentRect, childRect_i));
}
return nodes;
}
populateNodes();
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'SymmetricalLayout', springLength: 80, springFactor: 0.8, maxIteration: 500, margin: { left: 20, top: 20 } },
nodes: nodes, connectors: connectors,
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Line Distribution
Line distribution is used to arrange the connectors without overlapping in automatic layout. In some cases, the automatic layout connectors connecting to the nodes will be overlapped with one another. So user can decide whether the segment of each connector from a single parent node should be same point or different point. The connectionPointOrigin
property of layout is used to enable or disable the line distribution in layout. By default ConnectionPointOrigin will be SamePoint
.
The following code example illustrates how to create a complex hierarchical tree with line distribution.
Note: If you want to use line distribution in diagram layout, you need to inject LineDistribution module in the diagram.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.ComplexHierarchicalTree, ej.diagrams.LineDistribution );
var data = [
{ "Name": "node11" },
{ "Name": "node12", "ReportingPerson": ["node114"] },
{ "Name": "node13", "ReportingPerson": ["node12"] },
{ "Name": "node14", "ReportingPerson": ["node12"] },
{ "Name": "node15", "ReportingPerson": ["node12"] },
{ "Name": "node116", "ReportingPerson": ["node22","node12"] },
{ "Name": "node16", "ReportingPerson": [] },
{ "Name": "node18", "ReportingPerson": [] },
{ "Name": "node21" },
{ "Name": "node22", "ReportingPerson": ["node114"] },
{ "Name": "node23", "ReportingPerson": ["node22"] },
{ "Name": "node24", "ReportingPerson": ["node22"] },
{ "Name": "node25", "ReportingPerson": ["node22"] },
{ "Name": "node26", "ReportingPerson": [] },
{ "Name": "node28", "ReportingPerson": [] },
{ "Name": "node31" },
{ "Name": "node114", "ReportingPerson": ["node11", "node21", "node31"]}
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%',
height: '590px',
//Uses layout to auto-arrange nodes on the diagram page
layout: {
//Sets layout type
type: 'ComplexHierarchicalTree',
connectionPointOrigin: ej.diagrams.ConnectionPointOrigin.DifferentPoint,
horizontalSpacing: 40, verticalSpacing: 40, horizontalAlignment: "Left", verticalAlignment: "Top",
margin: { left: 0, right: 0, top: 0, bottom: 0 },
orientation: 'TopToBottom'
},//Configures data source for diagram
dataSourceSettings: {
id: 'Name',
parentId: 'ReportingPerson',
dataManager: items
},//Sets the default properties for nodes
getNodeDefaults: (obj) => {
obj.width = 40; obj.height = 40;
obj.shape = { type: 'Basic', shape: 'Rectangle', cornerRadius: 7 };
obj.style = { fill: '#6BA5D7', strokeColor: 'none', strokeWidth: 2 };
obj.borderWidth = 1;
obj.backgroundColor = '#6BA5D7';
return obj;
},//Sets the default properties for and connectors
getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
connector.cornerRadius = 7;
connector.targetDecorator.height = 7;
connector.targetDecorator.width = 7;
connector.style = { strokeColor: '#6BA5D7', strokeWidth: 1 };
connector.targetDecorator.style.fill = '#6BA5D7';
connector.targetDecorator.style.strokeColor = '#6BA5D7';
return connector;
}
});
diagram.appendTo('#element');
diagram.fitToPage({ mode: 'Width' });
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Linear Arrangement
Linear arrangement is used to linearly arrange the child nodes in layout, which means the parent node is placed in the center corresponding to its children. When line distribution is enabled, linear arrangement is also activated by default. The arrangement
property of layout is used to enable or disable the linear arrangement in layout. By default arrangement will be Nonlinear
.
Note: If you want to use linear arrangement in diagram layout, you need to inject LineDistribution module in the diagram. Linear arrangement is applicable only for complex hierarchical tree layout.
The following code illustrates how to allow a linear arrangement in diagram layout.
//Initialize diagram
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '590px',
layout: {
type: 'ComplexHierarchicalTree',
//To arrange a child nodes in a linear manner
arrangement: ChildArrangement.Linear,
horizontalSpacing: 40, verticalSpacing: 40,
orientation: 'TopToBottom',
},
},'#diagram');
Prevent connectors overlay
The below constraints prevents the connector segments overlapping nodes with a complex hierarchical layout.
//Initialize diagram
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '590px',
layout: {
//this prevents connector segments overlapping
enableRouting: true,
},
},'#diagram');
Customize layout
Orientation, spacings, and position of the layout can be customized with a set of properties.
To explore layout properties, refer to Layout Properties
.
Layout bounds
Diagram provides support to align the layout within any custom rectangular area. For more information about bounds, refer to bounds
.
Layout alignment
The layout can be aligned anywhere over the layout bounds/viewport using the horizontalAlignment
and verticalAlignment
properties of the layout.
The following code illustrates how to align the layout at the top-left of the layout bounds.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.ComplexHierarchicalTree, ej.diagrams.LineDistribution );
var data = [
{ "Name": "node11" },
{ "Name": "node12", "ReportingPerson": ["node114"] },
{ "Name": "node13", "ReportingPerson": ["node12"] },
{ "Name": "node14", "ReportingPerson": ["node12"] },
{ "Name": "node15", "ReportingPerson": ["node12"] },
{ "Name": "node116", "ReportingPerson": ["node22","node12"] },
{ "Name": "node16", "ReportingPerson": [] },
{ "Name": "node18", "ReportingPerson": [] },
{ "Name": "node21" },
{ "Name": "node22", "ReportingPerson": ["node114"] },
{ "Name": "node23", "ReportingPerson": ["node22"] },
{ "Name": "node24", "ReportingPerson": ["node22"] },
{ "Name": "node25", "ReportingPerson": ["node22"] },
{ "Name": "node26", "ReportingPerson": [] },
{ "Name": "node28", "ReportingPerson": [] },
{ "Name": "node31" },
{ "Name": "node114", "ReportingPerson": ["node11", "node21", "node31"]}
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%',
height: '590px',
//Uses layout to auto-arrange nodes on the diagram page
layout: {
//Sets layout type
type: 'ComplexHierarchicalTree',
connectionPointOrigin: ej.diagrams.ConnectionPointOrigin.DifferentPoint,
horizontalSpacing: 40, verticalSpacing: 40, horizontalAlignment: "Left", verticalAlignment: "Top",
margin: { left: 0, right: 0, top: 0, bottom: 0 },
orientation: 'TopToBottom'
},//Configures data source for diagram
dataSourceSettings: {
id: 'Name',
parentId: 'ReportingPerson',
dataManager: items
},//Sets the default properties for nodes
getNodeDefaults: (obj) => {
obj.width = 40; obj.height = 40;
obj.shape = { type: 'Basic', shape: 'Rectangle', cornerRadius: 7 };
obj.style = { fill: '#6BA5D7', strokeColor: 'none', strokeWidth: 2 };
obj.borderWidth = 1;
obj.backgroundColor = '#6BA5D7';
return obj;
},//Sets the default properties for and connectors
getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
connector.cornerRadius = 7;
connector.targetDecorator.height = 7;
connector.targetDecorator.width = 7;
connector.style = { strokeColor: '#6BA5D7', strokeWidth: 1 };
connector.targetDecorator.style.fill = '#6BA5D7';
connector.targetDecorator.style.strokeColor = '#6BA5D7';
return connector;
}
});
diagram.appendTo('#element');
diagram.fitToPage({ mode: 'Width' });
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Layout spacing
Layout provides support to add space horizontally and vertically between the nodes. The horizontalSpacing
and verticalSpacing
properties of the layout allows you to set the space between the nodes in horizontally and vertically.
Layout margin
Layout provides support to add some blank space between the layout bounds/viewport and the layout. The margin
property of the layout allows you to set the blank space.
The following code illustrates how to set the layout margin.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{Name: "Steve-Ceo"},
{Name: "Kevin-Manager", ReportingPerson: "Steve-Ceo"},
{Name: "Peter-Manager", ReportingPerson: "Kevin-Manager"},
{Name: "John- Manager", ReportingPerson: "Peter-Manager"},
{Name: "Mary-CSE ", ReportingPerson: "Peter-Manager"},
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'HierarchicalTree',bounds:new ej.diagrams.Rect(0,0,500,500),horizontalSpacing:25,verticalSpacing:30,horizontalAlignment:'Left',verticalAlignment:'Top' },
dataSourceSettings: { id: 'Name', parentId: 'ReportingPerson', dataManager: items },
getNodeDefaults: (obj) => {
obj.shape = { type: 'Text', content: (obj.data ).Name };
obj.style = { fill:'None', strokeColor: 'none',strokeWidth: 2, bold: true, color: 'white'};
obj.borderColor = 'black';
obj.width=100;
obj.height=40;
obj.backgroundColor = 'darkcyan';
obj.borderWidth = 1;
(obj.shape).margin = { left: 25, right: 25, top: 25, bottom: 25 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Layout orientation
The layout orientation can used to arrange the layout based on the direction. there are different orientation types that are defined in the following table.
Orientation | Description |
---|---|
TopToBottom | Aligns the layout from top to bottom. All the roots are placed at top of diagram. |
LeftToRight | Aligns the layout from left to right. All the roots are placed at left of diagram. |
BottomToTop | Aligns the layout from bottom to top. All the roots are placed at bottom of the diagram. |
RightToLeft | Aligns the layout from right to left. All the roots are placed at right of the diagram. |
Diagram provides support to customize the orientation
of layout. You can set the desired orientation using layout.orientation.
Note: In the diagram the default orientation is TopToBottom.
The following code illustrates how to arrange the nodes in a BottomToTop orientation.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data= [
{Name: "Steve-Ceo"},
{Name: "Kevin-Manager", ReportingPerson: "Steve-Ceo"},
{Name: "Peter-Manager", ReportingPerson: "Steve-Ceo"},
{Name: "John- Manager", ReportingPerson: "Peter-Manager"},
{Name: "Mary-CSE ", ReportingPerson: "Peter-Manager"},
{Name: "Jim-CSE ", ReportingPerson: "Kevin-Manager"},
{Name: "Martin-CSE", ReportingPerson: "Kevin-Manager"}];
var items = new ej.data.DataManager(data , new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'HierarchicalTree',bounds:new ej.diagrams.Rect(0,0,500,500),horizontalSpacing:25,verticalSpacing:30,horizontalAlignment:'Left',verticalAlignment:'Top',orientation:'BottomToTop'},
dataSourceSettings: { id: 'Name', parentId: 'ReportingPerson', dataManager: items },
getNodeDefaults: (obj) => {
obj.shape = { type: 'Text', content: (obj.data).Name };
obj.style = { fill:'None', strokeColor: 'none',strokeWidth: 2, bold: true, color: 'white'};
obj.borderColor = 'black';
obj.width=100;
obj.height=40;
obj.backgroundColor = 'darkcyan';
obj.borderWidth = 1;
(obj.shape ).margin = { left: 25, right: 25, top: 25, bottom: 25 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Fixed node
Layout provides support to arrange the nodes with reference to the position of a fixed node and set it to the fixedNode
of the layout property. This is helpful when you try to expand/collapse a node. It might be expected that the position of the double-clicked node should not be changed.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data= [
{Name: "Steve-Ceo"},
{Name: "Kevin-Manager", ReportingPerson: "Steve-Ceo"},
{Name: "Peter-Manager", ReportingPerson: "Steve-Ceo"},
{Name: "John- Manager", ReportingPerson: "Peter-Manager"},
{Name: "Mary-CSE ", ReportingPerson: "Peter-Manager"},
{Name: "Jim-CSE ", ReportingPerson: "Kevin-Manager"},
{Name: "Martin-CSE", ReportingPerson: "Kevin-Manager"}];
var items = new ej.data.DataManager(data , new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'HierarchicalTree',bounds:new ej.diagrams.Rect(0,0,500,500),horizontalSpacing:25,verticalSpacing:30,horizontalAlignment:'Left',verticalAlignment:'Top',orientation:'BottomToTop'},
dataSourceSettings: { id: 'Name', parentId: 'ReportingPerson', dataManager: items },
getNodeDefaults: (obj) => {
obj.shape = { type: 'Text', content: (obj.data).Name };
obj.style = { fill:'None', strokeColor: 'none',strokeWidth: 2, bold: true, color: 'white'};
obj.borderColor = 'black';
obj.width=100;
obj.height=40;
obj.backgroundColor = 'darkcyan';
obj.borderWidth = 1;
(obj.shape ).margin = { left: 25, right: 25, top: 25, bottom: 25 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.type = 'Orthogonal';
return connector;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
Expand and collapse
Diagram allows to expand/collapse the subtrees of a layout. The node’s isExpanded property allows you to expand/collapse its children. The following code example shows how to expand/collapse the children of a node.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{
'Id': 'parent1', 'Name': 'Maria ', 'Designation': 'Managing Director',
'ImageUrl': '../content/images/orgchart/Clayton.png', 'IsExpand': 'true', 'RatingColor': '#C34444'
},
{
'Id': 'parent', 'Name': ' sam', 'Designation': 'Managing Director', 'ReportingPerson': 'parent1',
'ImageUrl': '../content/images/orgchart/Clayton.png', 'IsExpand': 'true', 'RatingColor': '#C34444'
},
{
'Id': 'parent3', 'Name': ' sam geo', 'Designation': 'Managing Director', 'ReportingPerson': 'parent1',
'ImageUrl': '../content/images/orgchart/Clayton.png', 'IsExpand': 'true', 'RatingColor': '#C34444'
},
{
'Id': '80', 'Name': ' david', 'Designation': 'Managing Director', 'ReportingPerson': 'parent3',
'ImageUrl': '../content/images/orgchart/Clayton.png', 'IsExpand': 'true', 'RatingColor': '#C34444'
},
{
'Id': '82', 'Name': ' pirlo', 'Designation': 'Managing Director', 'ReportingPerson': 'parent',
'ImageUrl': '../content/images/orgchart/Clayton.png', 'IsExpand': 'true', 'RatingColor': '#C34444'
}
];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '590px', selectedItems: { constraints: ~ej.diagrams.SelectorConstraints.ResizeAll },
snapSettings: { constraints: 0 },
layout: {
enableAnimation: true,
type: 'OrganizationalChart', margin: { top: 20 },
getLayoutInfo: (node, tree) => {
if (!tree.hasSubTree) {
tree.orientation = 'vertical';
tree.type = 'alternate';
}
}
},
dataSourceSettings: {
id: 'Id', parentId: 'ReportingPerson', dataManager: items
},
getNodeDefaults: (obj, diagram) => {
obj.expandIcon = { height: 15, width: 15, shape: "Plus", fill: 'lightgray', offset: { x: .5, y: .85 } }
obj.collapseIcon.offset = { x: .5, y: .85 }
obj.collapseIcon.height = 15;
obj.collapseIcon.width = 15;
obj.collapseIcon.shape = "Minus";
obj.collapseIcon.fill = 'lightgray';
obj.height = 50;
obj.backgroundColor = 'lightgrey';
obj.style = { fill: 'transparent', strokeWidth: 2 };
return obj;
}, getConnectorDefaults: (connector, diagram) => {
connector.style = { strokeColor: '#6BA5D7', strokeWidth: 2 };
connector.targetDecorator.style.fill = '#6BA5D7';
connector.targetDecorator.style.strokeColor = 'white';
connector.targetDecorator.shape = 'None';
connector.type = 'Orthogonal';
return connector;
},
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>
In the previous example, while expanding/collapsing a node, it is set as fixed node in order to prevent it from repositioning.
Refresh layout
Diagram allows to refresh the layout at runtime. To refresh the layout, refer to Refresh layout.
setNodeTemplate
The setNodeTemplate function is provided for the purpose of customizing nodes. It will be called for each node on node initialization. In this function, the node style and its properties can be customized and can bind the custom JSON with node.
ej.diagrams.Diagram.Inject(ej.diagrams.DataBinding, ej.diagrams.HierarchicalTree);
var data = [
{Name: "Steve-Ceo"},
{Name: "Kevin-Manager", ReportingPerson: "Steve-Ceo",color:'darkcyan'},
{Name: "Peter-Manager", ReportingPerson: "Steve-Ceo",color:'white'},
{Name: "John- Manager", ReportingPerson: "Peter-Manager",color:'darkcyan'},
{Name: "Mary-CSE ", ReportingPerson: "Peter-Manager",color:'white'},
{Name: "Jim-CSE ", ReportingPerson: "Kevin-Manager",color:'darkcyan'},
{Name: "Martin-CSE", ReportingPerson: "Kevin-Manager",color:'white'}];
var items = new ej.data.DataManager(data, new ej.data.Query().take(7));
var diagram = new ej.diagrams.Diagram({
width: '100%', height: '550px',
layout: { type: 'HierarchicalTree',bounds:new ej.diagrams.Rect(0,0,500,500),horizontalSpacing:25,verticalSpacing:30,horizontalAlignment:'Left',verticalAlignment:'Top'},
dataSourceSettings: { id: 'Name', parentId: 'ReportingPerson', dataManager: items },
getNodeDefaults: (obj) => {
obj.shape = { type: 'Text', content: (obj.data ).Name };
obj.style = { fill:'None', strokeColor: 'none',strokeWidth: 2, bold: true, color: 'white'};
obj.borderColor = 'black';
obj.width=100;
obj.height=40;
obj.backgroundColor = 'darkcyan';
obj.borderWidth = 1;
(obj.shape ).margin = { left: 25, right: 25, top: 25, bottom: 25 };
return obj;
}, setNodeTemplate: function (obj, diagram) {
obj.style.color=(obj.data).color;
}
});
diagram.appendTo('#element');
<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Diagram</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Typescript UI Controls">
<meta name="author" content="Syncfusion">
<link href="index.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-splitbuttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-diagrams/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/23.1.36/ej2-navigations/styles/fabric.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/23.1.36/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div id="element"></div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>