Build Multi-Parent Hierarchical Trees with Angular Diagram Library

Jollen Moyani - Sep 6 '23 - - Dev Community

Hierarchical trees with multiple parents are also known as directed acyclic graphs (DAGs). They are powerful tools to represent complex relationships in various domains.

The Syncfusion Angular Diagram Library offers comprehensive features to create hierarchical diagrams with multiple parents. With these features and an intuitive API, you’ll be able to visualize intricate relationships with ease.

This blog is a quick guide to creating a hierarchical tree diagram with multiple parents using the Angular Diagram library.

Create a hierarchical tree diagram with multiple parents

The Syncfusion Angular Diagram component supports visualizing hierarchical trees with multiple parents from external data sources. In addition, data in any format can be easily converted, mapped, and consumed in the Diagram by setting a few properties.

We are going to design the following hierarchical tree in this article.

Creating a hierarichical tree with multiple parents using Angular Diagram library

Creating a hierarichical tree with multiple parents using Angular Diagram library

In this image, the rectangular boxes represent the nodes, and the curved lines represent the connectors.

Follow these steps to create this diagram:

  1. First, refer to the Getting Started with Angular Diagram library documentation to see the dependent scripts and theme files required to integrate the Diagram component into an Angular app.
  2. Define the tree information as a JSON array.
  3. Create an instance of the Angular Diagram component.
  4. Configure the data to the dataSourceSettings property of the created diagram instance.
  5. Define the common formatting for all nodes and connectors through the getNodeDefaults and getConnectorDefaults methods, respectively.
  6. After configuring the data source, define the layout type as ComplexHierarchicalTree to automatically arrange the nodes’ positions.

The following code example includes all these steps. You can also find the same code on StackBlitz.

[HTML]

<div class="control-section diagram-complex-hierarchical-tree">
 <div class="content-wrapper">
  <ejs-diagram #diagram id="diagram" width="100%" height="580px" [getConnectorDefaults]="connDefaults" [getNodeDefaults]="nodeDefaults" [tool]="tool" [layout]="layout" [dataSourceSettings]="data" [snapSettings]="snapSettings" (created)="created()">
  </ejs-diagram>
 </div>
</div>
Enter fullscreen mode Exit fullscreen mode

[TS]

import { Component, ViewEncapsulation, ViewChild } from '@angular/core';

import {
  DiagramComponent,
  LineDistribution,
} from '@syncfusion/ej2-angular-diagrams';

import {
  NodeModel,
  ConnectorModel,
  DiagramTools,
  Diagram,
  DataBinding,
  ComplexHierarchicalTree,
  SnapConstraints,
  SnapSettingsModel,
  LayoutModel,
  LayoutOrientation,
  ConnectionPointOrigin,
} from '@syncfusion/ej2-diagrams';
import { DataManager } from '@syncfusion/ej2-data';
import { ChangeEventArgs as NumericChangeEventArgs } from '@syncfusion/ej2-inputs';
import { ChangeEventArgs as CheckBoxChangeEventArgs } from '@syncfusion/ej2-buttons';
Diagram.Inject(DataBinding, ComplexHierarchicalTree, LineDistribution);

export interface DataInfo {
  [key: string]: string;
}

/**
 * Multiple parent sample.
 */
@Component({
  selector: 'app-root',
  templateUrl: 'app.component.html',
  styleUrls: ['app.component.css'],
  encapsulation: ViewEncapsulation.None,
})

export class AppComponent {
  @ViewChild('diagram')
  public diagram: DiagramComponent;

  public Data: any = [
    { Name: 'node11', fillColor: '#e7704c', border: '#c15433' },
    {
      Name: 'node12',
      ReportingPerson: ['node114'],
      fillColor: '#efd46e',
      border: '#d6b123',
    },
    {
      Name: 'node13',
      ReportingPerson: ['node12'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    {
      Name: 'node14',
      ReportingPerson: ['node12'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    {
      Name: 'node15',
      ReportingPerson: ['node12'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    {
      Name: 'node116',
      ReportingPerson: ['node22', 'node12'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    { Name: 'node16', ReportingPerson: [], fillColor: '#14ad85' },
    {
      Name: 'node17',
      ReportingPerson: ['node13', 'node14', 'node15'],
      fillColor: '#659be5',
      border: '#3a6eb5',
    },
    { Name: 'node18', ReportingPerson: [], fillColor: '#14ad85' },
    {
      Name: 'node19',
      ReportingPerson: ['node16', 'node17', 'node18'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    {
      Name: 'node110',
      ReportingPerson: ['node16', 'node17', 'node18'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    {
      Name: 'node111',
      ReportingPerson: ['node16', 'node17', 'node18', 'node116'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    { Name: 'node21', fillColor: '#e7704c', border: '#c15433' },
    {
      Name: 'node22',
      ReportingPerson: ['node114'],
      fillColor: '#efd46e',
      border: '#d6b123',
    },
    {
      Name: 'node23',
      ReportingPerson: ['node22'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    {
      Name: 'node24',
      ReportingPerson: ['node22'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    {
      Name: 'node25',
      ReportingPerson: ['node22'],
      fillColor: '#58b087',
      border: '#16955e',
    },
    { Name: 'node26', ReportingPerson: [], fillColor: '#14ad85' },
    {
      Name: 'node27',
      ReportingPerson: ['node23', 'node24', 'node25'],
      fillColor: '#659be5',
      border: '#3a6eb5',
    },
    { Name: 'node28', ReportingPerson: [], fillColor: '#14ad85' },
    {
      Name: 'node29',
      ReportingPerson: ['node26', 'node27', 'node28', 'node116'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    {
      Name: 'node210',
      ReportingPerson: ['node26', 'node27', 'node28'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    {
      Name: 'node211',
      ReportingPerson: ['node26', 'node27', 'node28'],
      fillColor: '#8dbe6c',
      border: '#489911',
    },
    { Name: 'node31', fillColor: '#e7704c', border: '#c15433' },
    {
      Name: 'node114',
      ReportingPerson: ['node11', 'node21', 'node31'],
      fillColor: '#f3904a',
      border: '#d3722e',
    },
  ];

  public nodeDefaults(obj: NodeModel): NodeModel {
    obj.width = 40;
    obj.height = 40;
    //Initialize shape.
    obj.shape = { type: 'Basic', shape: 'Rectangle', cornerRadius: 7 };
    return obj;
  }


  public data: Object = {
    id: 'Name',
    parentId: 'ReportingPerson',
    dataSource: new DataManager(this.Data),
    //Binds the external data with the node.
    doBinding: (nodeModel: NodeModel, data: DataInfo, diagram: Diagram) => {
      /* tslint:disable:no-string-literal */
      nodeModel.style = {
        fill: data['fillColor'],
        strokeWidth: 1,
        strokeColor: data['border'],
      };
    },
  };


  public created(): void {
    this.diagram.fitToPage();
  }


  public connDefaults(connector: ConnectorModel): void {
    connector.type = 'Orthogonal';
    connector.cornerRadius = 7;
    connector.targetDecorator.height = 7;
    connector.targetDecorator.width = 7;
    connector.style.strokeColor = '#6d6d6d';
  }

  public tool: DiagramTools = DiagramTools.ZoomPan;

  public snapSettings: SnapSettingsModel = {
    constraints: SnapConstraints.None,
  };

  public layout: LayoutModel = {
    type: 'ComplexHierarchicalTree',
    connectionPointOrigin: ConnectionPointOrigin.DifferentPoint,
    horizontalSpacing: 40,
    verticalSpacing: 40,
    orientation: 'TopToBottom',
    margin: { left: 10, right: 0, top: 50, bottom: 0 },
  };
}
Enter fullscreen mode Exit fullscreen mode

Expand and collapse children

You can use the expandIcon and collapseIcon properties of nodes to implement the expand and collapse features in the hierarchical tree’s children nodes.

Refer to the following code example and find the same on StackBlitz.

private getNodeDefaults(obj: NodeModel): NodeModel {
    ........ 
    obj.expandIcon = {
      shape: 'Minus',
    };
    obj.collapseIcon = {
      shape: 'Plus',
    };
    ........ 
    return obj;
}
Enter fullscreen mode Exit fullscreen mode

Expanding and collapsing nodes in a hierarchical tree with multiple parents using the Angular Diagram component

Expanding and collapsing nodes in a hierarchical tree with multiple parents using the Angular Diagram component

Drag and drop

You can easily change the multiparent tree layout by dragging a topic or subtopic and dropping it at the required location.

Add the following code to the Diagram control’s drop method to enable editing in the hierarchical tree structure. The same code is also available on StackBlitz.

public drop(args: IDropEventArgs) {
    //Argument element is used to get the dropped node.
    let node: NodeModel = args.element as NodeModel;
    //Gets the connector that connected to dropped node.
    let edges: string[] = this.diagram.getEdges(node);
    let connector: ConnectorModel = this.diagram.getObject(edges[0]);
    //Argument target is used to get the hovered node.
    connector.sourceID = (args.target as NodeModel).id;
    this.diagram.dataBind();
    // doLayout is used to rearrange the nodes and connectors in the diagram.
    this.diagram.doLayout();
}
Enter fullscreen mode Exit fullscreen mode

Dragging and dropping nodes in a hierarchical tree with multiple parents using the Angular Diagram component

Dragging and dropping nodes in a hierarchical tree with multiple parents using the Angular Diagram component

Spacing

You can adjust the spacing between each level of the multiparent tree diagram both horizontally and vertically. You can also define a margin around the multiparent diagram.

Refer to the following code example and find it on StackBlitz.

public layout: LayoutModel = {
    type: 'ComplexHierarchicalTree',
    connectionPointOrigin: ConnectionPointOrigin.DifferentPoint,
    horizontalSpacing: 70,
    verticalSpacing: 70,
    orientation: 'TopToBottom',
    margin: { left: 10, right: 0, top: 50, bottom: 0 },
};
Enter fullscreen mode Exit fullscreen mode

Customizing the spacing between nodes in a multiparent hierarchical tree using Angular Diagram component

Customizing the spacing between nodes in a multiparent hierarchical tree using Angular Diagram component

Zooming and panning

Viewing a large diagram on a small screen can be challenging. In that case, zooming and panning help us provide a more detailed view of the hierarchical tree diagram.

You can zoom in and out of the diagram using the Ctrl + mouse wheel shortcut key.

Refer to the following code examples (or on StackBlitz) to enable zooming and panning support in the Diagram component.

[HTML]

<div class="control-section diagram-complex-hierarchical-tree">
 <div class="content-wrapper">
  <ejs-diagram #diagram id="diagram" width="100%" height="800px" [getConnectorDefaults]="connDefaults" [getNodeDefaults]="nodeDefaults" [layout]="layout" [tool]="tool" [dataSourceSettings]="data" [snapSettings]="snapSettings" (created)="created()" (drop)="drop($event)">
  </ejs-diagram>
 </div>
</div>
Enter fullscreen mode Exit fullscreen mode

[TS]

//Enable pan tool
  public tool: DiagramTools = DiagramTools.ZoomPan;
Enter fullscreen mode Exit fullscreen mode

Zooming and panning in the multiparent hierarchical tree using the Angular Diagram component

Zooming and panning in the multiparent hierarchical tree using the Angular Diagram component

Exporting

You can easily export the diagram to different image formats such as PNG, JPEG, and SVG.

Refer to the following code example (or on StackBlitz) to explore this feature.

let exportOptions: IExportOptions = {};
    exportOptions.format = args.item.text as FileFormats;
    exportOptions.mode = 'Download';
    exportOptions.region = 'Content';
    exportOptions.multiplePage = false;
    exportOptions.fileName = HierarchicalTree;
    this.diagram.exportDiagram(exportOptions);
Enter fullscreen mode Exit fullscreen mode

Conclusion

Thanks for reading! In this blog, we’ve seen how to create and customize a multiparent hierarchical tree diagram using the Syncfusion Angular Diagram library. With the same component, you can also create flowcharts, organizational charts, floor plans, UML diagrams, and BPMN charts. Try out the steps in this blog, and give us your feedback in the comments section!

If you want to try the Diagram library, you can download our free trial. You can see the Diagram library live demo and documentation for detailed explanations.

If you have any questions, you can contact us through our support forum, support portal, or feedback portal. We are always happy to assist you!

Related blogs

Image
tanda-tanda situs bandar judi slots online sah bisa dipercaya
Image
15 Things You Didn't Know About Average Payout For Asbestos Claims
Image
5 Qualities That People Are Looking For In Every Asbestos Attorneys Oklahoma
Image
How to Enable IIS Management Console in Windows 11?

winsides, windows11, tips, tutorials
Image
Asbestos And Peritoneal Mesothelioma Tips From The Top In The Industry
Image
Ten Accident Lawyers That Will Actually Help You Live Better
Image
Why You'll Need To Learn More About Lpg Gas Engineer Near Me
Image
10 Essentials Concerning Accidents Lawyer You Didn't Learn In School
Image
20 Bi Fold Repairs Websites That Are Taking The Internet By Storm
Image
10 Unexpected Bi Fold Door Repair Tips
Image
Tips Main Judi Online24jam Deposit Uang
Image
Two New LINQ Methods in .NET 9: CountBy and Index

csharp, beginners, tutorial, dotnet
Image
Advanced ReactJS Folder Structure: Best Practices for Scalability and Maintainability

webdev, javascript, react
Image
15 Reasons Why You Shouldn't Ignore Asbestos Related Death Compensation
Image
What Do You Think? Heck Is Accident Claims Lawyers?
Image
My Hacktoberfest Journey: From Beginner to Confident Contributor

devchallenge, hacktoberfestchallenge, hacktoberfest, opensource
Image
teknik menang slots online dengan sangat kencang
Image
It's Enough! 15 Things About Asbestos Exposure Attorney We're Overheard
Image
Yok Singkirkan saat ini serta raup keuntungan besarnya dari judi online
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .