React

Search results

Connector in React Diagram component

24 Sep 2021 / 29 minutes to read

Connectors are objects used to create link between two points, nodes or ports to represent the relationships between them.

Create connector

Connector can be created by defining the source and target point of the connector. The path to be drawn can be defined with a collection of segments. To explore the properties of a connector, refer to Connector Properties.

Add connectors through connectors collection

The sourcePoint and targetPoint properties of connector allow you to define the end points of a connector.

The following code example illustrates how to add a connector through connector collection.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
    Diagram,
    DiagramComponent,
    ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let connectors: ConnectorModel = [{
    // Name of the connector
    id: "connector1",
    style: {
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        strokeWidth: 2
    },
    targetDecorator: {
        style: {
            fill: '#6BA5D7',
            strokeColor: '#6BA5D7'
        }
    },
    // Sets source and target points
    sourcePoint: {
        x: 100,
        y: 100
    },
    targetPoint: {
        x: 200,
        y: 200
    }
}];

ReactDOM.render( <DiagramComponent     id="diagram"
        width = {
            '100%'
        }
        height = {
            '600px'
        }
        connectors = {
            connectors
        }
        />,   document.getElementById("diagram") );

Add connector at runtime

Connectors can be added at runtime by using public method, diagram.add and can be removed at runtime by using public method, diagram.remove.

The following code example illustrates how to add connector at runtime.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
    Diagram,
    DiagramComponent,
    ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let diagramInstance: DiagramComponent;
let connectors: ConnectorModel = [{
    id: 'connector1',
    style: {
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        strokeWidth: 2
    },
    targetDecorator: {
        style: {
            fill: '#6BA5D7',
            strokeColor: '#6BA5D7'
        }
    },
    sourcePoint: {
        x: 100,
        y: 100
    },
    targetPoint: {
        x: 200,
        y: 200
    }
}];
ReactDOM.render( <DiagramComponent id="diagram" ref={diagram => (diagramInstance = diagram)}
        width = {
            '100%'
        }
        height = {
            '600px'
        }
        created = {
            () => {
                // Adds to the Diagram
                diagramInstance.add(connectors)
                // Remove from the diagram
                diagramInstance.remove(connectors)
            }
        }
        />,   document.getElementById("diagram") );

Connectors from palette

Connectors can be predefined and added to the symbol palette. You can drop those connectors into the diagram, when required.

For more information about adding connectors from symbol palette, refer to Symbol Palette.

Draw connectors

Connectors can be interactively drawn by clicking and dragging on the diagram surface by using drawingObject.

For more information about drawing connectors, refer to Draw Connectors.

Update connector at runtime

Various connector properties such as sourcePoint, targetPoint, style, sourcePortID, targetPortID, etc., can be updated at the runtime.

The following code example illustrates how to update a connector’s source point, target point, styles properties at runtime.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
    Diagram,
    DiagramComponent,
    ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
    id: "connector1",
    sourcePoint: {
        x: 100,
        y: 100
    },
    targetPoint: {
        x: 200,
        y: 200
    }
}];
let diagramInstance: DiagramComponent;
ReactDOM.render( <DiagramComponent     id="diagram" ref={diagram => diagramInstance = diagram}
        width = {
            '100%'
        }
        height = {
            '600px'
        }
        connectors = {
            connectors
        }
        />,   document.getElementById("diagram") );
        // Update the connector properties at the run time
        diagramInstance.connectors[0].style.strokeColor = '#6BA5D7';
        diagramInstance.connectors[0].style.fill = '#6BA5D7';
        diagramInstance.connectors[0].style.strokeWidth = 2;
        diagramInstance.connectors[0].targetDecorator.style.fill = '#6BA5D7';
        diagramInstance.connectors[0].targetDecorator.style.strokeColor = '#6BA5D7';
        diagramInstance.connectors[0].sourcePoint.x = 150;
        diagramInstance.connectors[0].targetPoint.x = 150;
        diagramInstance.dataBind();

Connect nodes

The sourceID and targetID properties allow to define the nodes to be connected.
The following code example illustrates how to connect two nodes.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
NodeModel,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let nodes: NodeModel[] = [{
    id: 'Start',
    width: 140,
    height: 50,
    offsetX: 300,
    offsetY: 100,
    annotations: [{
        id: 'label1',
        content: 'Start'
    }],
    shape: {
        type: 'Flow',
        shape: 'Terminator'
    }
},
{
    id: 'Init',
    width: 140,
    height: 50,
    offsetX: 300,
    offsetY: 300,
    shape: {
        type: 'Flow',
        shape: 'Process'
    },
    annotations: [{
        content: 'var i = 0;'
    }]
}
];
let connectors: ConnectorModel[] = [{
// Name of the connector
id: "connector1",
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
// ID of the source and target nodes
sourceID: "Start",
targetID: "Init",
type: 'Orthogonal'
}];

ReactDOM.render( <DiagramComponent id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    nodes = {
        nodes
    }
    connectors = {
        connectors
    }
    // Defines the default properties for the node
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    />,   document.getElementById("diagram") );

When you remove NodeConstraints InConnect from Default, the node accepts only an outgoing connection to dock in it. Similarly, when you remove NodeConstraints OutConnect from Default, the node accepts only an incoming connection to dock in it.
When you remove both InConnect and OutConnect NodeConstraints from Default, the node restricts connector to establish connection in it.
The following code illustrates how to disable InConnect constraints.

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
NodeModel,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let nodes: NodeModel[] = [{
    id: 'Start',
    width: 140,
    height: 50,
    offsetX: 300,
    offsetY: 100,
    //Disable InConnect constraints
    constraints: NodeConstraints.Default & ~NodeConstraints.InConnect,
}
];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    nodes = {
        nodes
    }
    />,   document.getElementById("diagram") );

Connections with ports

The sourcePortID and targetPortID properties allow to create connections between some specific points of source/target nodes. The following code example illustrates how to create port to port connections.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
ConnectorModel,
NodeModel,
BasicShapeModel,
PointPortModel,
Diagram,
DiagramComponent,
PortVisibility
} from "@syncfusion/ej2-react-diagrams";

let port1: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
port1.shape = 'Circle';
port1.id = 'nodeportnew';
port1.visibility = PortVisibility.Visible;
port1.id = 'port';
port1.offset = {
x: 1,
y: 1
};
let port2: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
port2.offset = {
x: 1,
y: 0.5
};
port2.id = 'port1';
port2.visibility = PortVisibility.Visible;
port2.shape = 'Circle';
let port3: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
port3.offset = {
x: 0,
y: 1
};
port3.id = 'newnodeport1';
port3.visibility = PortVisibility.Visible;
port3.shape = 'Circle';
let nodes: NodeModel[] = [{
    id: 'node',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 100,
    ports: [port1]
},
{
    id: 'node1',
    width: 100,
    height: 100,
    offsetX: 300,
    offsetY: 100,
    ports: [port2, port3]
},
];

let connectors: ConnectorModel[] = [{
id: "connector1",
sourceID: 'node',
targetID: 'node1',
sourcePortID: 'port1',
targetPortID: 'port2'
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        900
    }
    height = {
        900
    }
    nodes = {
        nodes
    }
    connectors = {
        connectors
    }
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    />,   document.getElementById("diagram") );

Similarly, the sourcePortID or targetPortID can be changed at the runtime by changing the port sourcePortID or targetPortID.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
ConnectorModel,
NodeModel,
BasicShapeModel,
PointPortModel,
Diagram,
DiagramComponent,
PortVisibility
} from "@syncfusion/ej2-react-diagrams";

let port1: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
}
port1.shape = 'Circle';
port1.id = 'nodeportnew'
port1.visibility = PortVisibility.Visible
port1.id = 'port';
port1.offset = {
x: 1,
y: 1
};
let port2: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
port2.offset = {
x: 1,
y: 0.5
};
port2.id = 'port1';
port2.visibility = PortVisibility.Visible
port2.shape = 'Circle';
let port3: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
port3.offset = {
x: 0,
y: 1
};
port3.id = 'newnodeport1';
port3.visibility = PortVisibility.Visible
port3.shape = 'Circle';
let nodes: NodeModel[] = [{
    id: 'node',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 100,
    ports: [port1]
},
{
    id: 'node1',
    width: 100,
    height: 100,
    offsetX: 300,
    offsetY: 100,
    ports: [port2, port3]
},
];
let diagramInstance: DiagramComponent;

let connectors: ConnectorModel[] = [{
        id: "connector1",
        sourcePoint: {
            x: 100,
            y: 100
        },
        type: 'Orthogonal',
        targetPoint: {
            x: 200,
            y: 200
        },
        sourceID: 'node',
        targetID: 'node1',
        sourcePortID: 'port',
        targetPortID: 'port1'
    }];

    ReactDOM.render( <DiagramComponent     id="diagram" ref={diagram => diagramInstance = diagram}
        width = {
            900
        }
        height = {
            900
        }
        nodes = {
            nodes
        }
        connectors = {
            connectors
        }
        getNodeDefaults = {
            (node: NodeModel) => {
                node.height = 100;
                node.width = 100;
                node.style.fill = '#6BA5D7';
                node.style.strokeColor = 'white';
                return node;
            }
        }
        />,   document.getElementById("diagram") );
        // Update the target portID at the run time
        diagramInstance.connectors[0].targetPortID = 'newnodeport1'

When you set PortConstraints to InConnect, the port accepts only an incoming connection to dock in it. Similarly, when you set PortConstraints to OutConnect, the port accepts only an outgoing connection to dock in it.
When you set PortConstraints to None, the port restricts connector to establish connection in it.

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
ConnectorModel,
NodeModel,
BasicShapeModel,
PointPortModel,
Diagram,
DiagramComponent,
PortVisibility
} from "@syncfusion/ej2-react-diagrams";

let port1: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
}
port1.shape = 'Circle';
port1.id = 'nodeportnew';
 //Enable portConstraints Inconnect
port1.constraints = PortConstraints.InConnect;

let nodes: NodeModel[] = [{
    id: 'node',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 150,
    ports: [port1]
},
];

ReactDOM.render( <DiagramComponent     id="diagram"
        width = {
            900
        }
        height = {
            900
        }
        nodes = {
            nodes
        }
        />,   document.getElementById("diagram") );

Segments

The path of the connector is defined with a collection of segments. There are three types of segments.

Straight

To create a straight line, specify the type of the segment as straight and add a straight segment to segments collection and need to specify type for the connector. The following code example illustrates how to create a default straight segment.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel,
StraightSegmentModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: "connector1",
type: 'Straight',
segments: [{
    // Defines the segment type of the connector
    type: 'Straight'
}],
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

The point property of straight segment allows you to define the end point of it. The following code example illustrates how to define the end point of a straight segment.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel,
StraightSegmentModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: "connector1",
// Defines the segment type of the connector
segments: [{
    type: 'Straight',
    // Defines the point of the segment
    point: {
        x: 100,
        y: 150
    }
}],
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
type: 'Straight',
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Orthogonal

Orthogonal segments is used to create segments that are perpendicular to each other.

Set the segment type as orthogonal to create a default orthogonal segment and need to specify type. The following code example illustrates how to create a default orthogonal segment.

Multiple segments can be defined one after another. To create a connector with multiple segments, define and add the segments to connector.segments collection. The following code example illustrates how to create a connector with multiple segments.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel,
OrthogonalSegmentModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: "connector1",
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
},
type: 'Orthogonal',
segments: [{ type: 'Orthogonal', direction: 'Bottom', length: 50 }],

}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

The length and direction properties allow to define the flow and length of segment. The following code example illustrates how to create customized orthogonal segments.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel,
OrthogonalSegmentModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
    id: "connector1",
    type: 'Orthogonal',
    segments: [{
        type: 'Orthogonal',
        // Defines the direction for the segment lines
        direction: 'Right',
        // Defines the length for the segment lines
        length: 50
    }],
    style: {
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        strokeWidth: 2
    },
    targetDecorator: {
        style: {
            fill: '#6BA5D7',
            strokeColor: '#6BA5D7'
        }
    },
    sourcePoint: {
        x: 100,
        y: 100
    },
    targetPoint: {
        x: 200,
        y: 200
    }
},
{
    id: "connector2",
    type: 'Orthogonal',
    // Defines multile segemnts for the connectors
    segments: [{
            type: 'Orthogonal',
            direction: 'Bottom',
            length: 150
        },
        {
            type: 'Orthogonal',
            direction: 'Right',
            length: 150
        }
    ],
    style: {
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        strokeWidth: 2
    },
    targetDecorator: {
        style: {
            fill: '#6BA5D7',
            strokeColor: '#6BA5D7'
        }
    },
    sourcePoint: {
        x: 300,
        y: 100
    },
    targetPoint: {
        x: 400,
        y: 200
    }
}
];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Note: You need to mention the segment type as same as what you mentioned in connector type. There should be no contradiction between connector type and segment type.

Avoid overlapping

Orthogonal segments are automatically re-routed, in order to avoid overlapping with the source and target nodes. The following preview illustrates how orthogonal segments are re-routed.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
ConnectorModel,
NodeModel,
DiagramComponent,
BasicShapeModel,
PointPortModel,
Diagram,
PortVisibility
} from "@syncfusion/ej2-react-diagrams";

let nodeport: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
};
nodeport.shape = 'Circle';
nodeport.visibility = PortVisibility.Visible
nodeport.id = 'port';
nodeport.offset = {
x: 0,
y: 0.5
};
let port2: PointPortModel = {
style: {
    strokeColor: '#366F8C',
    fill: '#366F8C'
}
}
port2.offset = {
x: 0,
y: 0.5
};
port2.id = 'port1';
port2.visibility = PortVisibility.Visible
port2.shape = 'Circle';
let nodes: NodeModel[] = [{
    id: 'node',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 100,
    ports: [nodeport]
},
{
    id: 'node1',
    width: 100,
    height: 100,
    offsetX: 300,
    offsetY: 100,
    ports: [port2]
},
];

let connectors: ConnectorModel[] = [{
id: "connector1",
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
type: 'Orthogonal',
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
},
sourceID: 'node',
targetID: 'node1',
sourcePortID: 'port',
targetPortID: 'port1'
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        900
    }
    height = {
        900
    }
    nodes = {
        nodes
    }
    connectors = {
        connectors
    }
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    />,   document.getElementById("diagram") );

Bezier

Bezier segments are used to create curve segments and the curves are configurable either with the control points or with vectors.

To create a bezier segment, the segment.type is set as bezier and need to specify type for the connector. The following code example illustrates how to create a default bezier segment.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: 'connector1',
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
type: 'Bezier',
segments: [{
    // Defines the type of the segment
    type: 'Bezier',
}],
sourcePoint: {
    x: 50,
    y: 100
},
targetPoint: {
    x: 150,
    y: 200
},
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

The point1 and point2 properties of bezier segment enable you to set the control points. The following code example illustrates how to configure the bezier segments with control points.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let connectors: ConnectorModel[] = [

{
    id: 'connector3',
    type: 'Bezier',
    style: {
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        strokeWidth: 2
    },
    targetDecorator: {
        style: {
            fill: '#6BA5D7',
            strokeColor: '#6BA5D7'
        }
    },
    segments: [{
        type: 'Bezier',
        // First control point: an absolute position from the page origin
        point1: {
            x: 100,
            y: 100
        },
        // Second control point: an absolute position from the page origin
        point2: {
            x: 200,
            y: 200
        }
    }],
    sourcePoint: {
        x: 100,
        y: 200
    },
    targetPoint: {
        x: 200,
        y: 100
    },
}
];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

The vector1 and vector2 properties of bezier segment enable you to define the vectors. The following code illustrates how to configure a bezier curve with vectors.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let connectors: ConnectorModel[] = [{
id: 'connector2',
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
// Defines the type of the segment
type: 'Bezier',
segments: [{
    type: 'Bezier',
    // Length and angle between the source point and the first control point
    vector1: {
        distance: 100,
        angle: 90
    },
    // Length and angle between the target point and the second control point
    vector2: {
        distance: 45,
        angle: 270
    }
}],
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
},
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Decorator

Starting and ending points of a connector can be decorated with some customizable shapes like arrows, circles, diamond, or path. The connection end points can be decorated with the sourceDecorator and targetDecorator properties of the connector.
The shape property of sourceDecorator allows to define the shape of the decorators. Similarly, the shape property of targetDecorator allows to define the shape of the decorators.
To create custom shape for source decorator, use pathData property. Similarly, to create custom shape for target decorator, use pathData property.
The following code example illustrates how to create decorators of various shapes.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let connectors: ConnectorModel[] = [{
id: "connector1",
type: 'Straight',
// Decorator shape- circle
sourceDecorator: {
    shape: 'Circle',
    // Defines the style for the sourceDecorator
    style: {
        // Defines the strokeWidth for the sourceDecorator
        strokeWidth: 3,
        // Defines the strokeColor for the sourceDecorator
        strokeColor: 'red'
    },

},
// Decorator shape - Diamond
targetDecorator: {
    // Defines the custom shape for the connector's target decorator
    shape: 'Custom',
    //Defines the  path for the connector's target decorator
    pathData: 'M80.5,12.5 C80.5,19.127417 62.59139,24.5 40.5,24.5 C18.40861,24.5 0.5,19.127417 0.5,12.5' +
        'C0.5,5.872583 18.40861,0.5 40.5,0.5 C62.59139,0.5 80.5,5.872583 80.5,12.5 z',
    //defines the style for the target decorator
    style: {
        // Defines the strokeWidth for the targetDecorator
        strokeWidth: 3,
        // Defines the strokeColor for the sourceDecorator
        strokeColor: 'green',
        // Defines the opacity for the sourceDecorator
        opacity: .8
    },
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}, {
id: "connectors2",
type: 'Straight',
// Decorator shape - IndentedArrow
sourceDecorator: {
    shape: 'IndentedArrow',
    style: {
        strokeWidth: 3,
        strokeColor: 'blue'
    },

},
// Decorator shape - OutdentedArrow
targetDecorator: {
    shape: 'OutdentedArrow',
    style: {
        strokeWidth: 3,
        strokeColor: 'yellow'
    },
},
sourcePoint: {
    x: 400,
    y: 100
},
targetPoint: {
    x: 300,
    y: 200
}
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Padding

Padding is used to leave the space between the Connector’s end point and the object to where it is connected.

The sourcePadding property of connector defines space between the source point and the source node of the connector.
The targetPadding property of connector defines space between the end point and the target node of the connector.
The following code example illustrates how to leave space between the connection end points and source and target nodes.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
NodeModel,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let nodes: NodeModel[] = [{
   id: 'node',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 100,
},
{
     id: 'node1',
    width: 100,
    height: 100,
    offsetX: 300,
    offsetY: 100,
}
];
let connectors: ConnectorModel[] = [{
// Name of the connector
id: "connector1",
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
// ID of the source and target nodes
sourceID: "node",
targetID: "node1",
// Set Source Padding value
sourcePadding:20,
// Set Target Padding value
targetPadding:20
}];

ReactDOM.render( <DiagramComponent id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    nodes = {
        nodes
    }
    connectors = {
        connectors
    }
    // Defines the default properties for the node
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    />,   document.getElementById("diagram") );

Flip

The diagram Provides support to flip the connector. The flip is performed to give the mirrored image of the original element. The flip types are as follows:

HorizontalFlip Horizontal is used to interchange the connector source and target x points.
VerticalFlip Vertical is used to interchange the connector source and target y points.
Both Both is used to interchange the source point as target point and target point as source point

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
// Name of the connector
id: "connector1",
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
},
// Flip the connector in horizontal direction
  flip:"Horizontal"
}];

ReactDOM.render( <DiagramComponent id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Note: The flip is not applicable when the connectors connect in nodes

Bridging

Line bridging creates a bridge for lines to smartly cross over the other lines, at points of intersection. By default, bridgeDirection is set to top. Depending upon the direction given bridging direction appears. Bridging can be enabled/disabled either with the connector.constraints or diagram.constraints. The following code example illustrates how to enable line bridging.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
Inject,
ConnectorBridging,
DiagramConstraints,
ConnectorModel,
NodeModel
} from "@syncfusion/ej2-react-diagrams";

let node1: NodeModel[] = [{
id: 'Transaction',
width: 150,
height: 60,
offsetX: 300,
offsetY: 60,
shape: {
    type: 'Flow',
    shape: 'Terminator'
},
annotations: [{
    id: 'label1',
    content: 'Start Transaction',
    offset: {
        x: 0.5,
        y: 0.5
    }
}],
}, {
id: 'Verification',
width: 150,
height: 60,
offsetX: 300,
offsetY: 250,
shape: {
    type: 'Flow',
    shape: 'Process'
},
annotations: [{
    id: 'label2',
    content: 'Verification',
    offset: {
        x: 0.5,
        y: 0.5
    }
}]
}];

let connectors: ConnectorModel[] = [{
id: 'connector1',
type: 'Straight',
sourceID: 'Transaction',
targetID: 'Verification'
}, {
id: 'connector2',
type: 'Straight',
sourcePoint: {
    x: 200,
    y: 130
},
targetPoint: {
    x: 400,
    y: 130
}
}, {
id: 'connector3',
type: 'Straight',
sourcePoint: {
    x: 200,
    y: 170
},
targetPoint: {
    x: 400,
    y: 170
}
}];
// Enables bridging for every connector added in the model
ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    getConnectorDefaults = {
        (obj: ConnectorModel): ConnectorModel => {
            obj.style.strokeColor = '#6BA5D7';
            obj.style.fill = '#6BA5D7';
            obj.style.strokeWidth = 2;
            obj.targetDecorator.style.fill = '#6BA5D7';
            obj.targetDecorator.style.strokeColor = '#6BA5D7';
            return obj;
        }
    }
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    nodes = {
        node1
    }
    height = {
        '600px'
    }
    // Enables the bridging constraints for the connector
    constraints = {
        DiagramConstraints.Default | DiagramConstraints.Bridging
    }
    connectors = {
        connectors
    }
    >< Inject services = {
        [ConnectorBridging]
    }
    /> </DiagramComponent>,   document.getElementById("diagram") );

Note: You need to inject connector bridging module into the diagram.

The bridgeSpace property of connectors can be used to define the width for line bridging.

Limitation: Bezier segments do not support bridging.

Corner radius

Corner radius allows to create connectors with rounded corners. The radius of the rounded corner is set with the cornerRadius property.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
NodeModel,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let nodes: NodeModel[] = [{
    id: 'node1',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 100,
},
{
    id: 'node2',
    width: 100,
    height: 100,
    offsetX: 100,
    offsetY: 350,
}
];

let connectors: ConnectorModel[] = [{
id: "connector1",
type: 'Orthogonal',
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
// Sets the radius for the rounded corner
cornerRadius: 10,
sourceID: 'node1',
targetID: 'node2',
segments: [{
    type: 'Orthogonal',
    direction: 'Right',
    length: 50
}],
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    nodes = {
        nodes
    }
    getNodeDefaults = {
        (node: NodeModel) => {
            node.height = 100;
            node.width = 100;
            node.style.fill = '#6BA5D7';
            node.style.strokeColor = 'white';
            return node;
        }
    }
    />,   document.getElementById("diagram") );

Appearance

The connector’s strokeWidth, strokeColor, strokeDashArray, and opacity properties are used to customize the appearance of the connector segments.
The visible property of the connector enables or disables the visibility of connector.
Default values for all the connectors can be set using the getConnectorDefaults properties. For example, if all connectors have the same type or having the same property then such properties can be moved into getConnectorDefaults.

Segment appearance

The following code example illustrates how to customize the segment appearance.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
    id: "connector1",
    targetDecorator: {
        style: {
            strokeColor: '#6BA5D7',
            fill: '#6BA5D7',
            strokeWidth: 2
        }
    },
    style: {
        // Stroke color
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        // Stroke width of the line
        strokeWidth: 2,
        // Line style
        strokeDashArray: '2,2'
    },
    sourcePoint: {
        x: 100,
        y: 100
    },
    targetPoint: {
        x: 200,
        y: 200
    },
    segments: [{
        type: 'Orthogonal',
        direction: 'Right',
        length: 50
    }],
},
{
    id: "connector2",
    // Set the visibility of the connector to false
    visible: false,
    targetDecorator: {
        style: {
            strokeColor: '#6BA5D7',
            fill: '#6BA5D7',
            strokeWidth: 2
        }
    },
    style: {
        // Stroke color
        strokeColor: '#6BA5D7',
        fill: '#6BA5D7',
        // Stroke width of the line
        strokeWidth: 2,
        // Line style
        strokeDashArray: '2,2'
    },
    sourcePoint: {
        x: 300,
        y: 300
    },
    targetPoint: {
        x: 400,
        y: 400
    },
    segments: [{
        type: 'Orthogonal',
        direction: 'Right',
        length: 50
    }],
}
];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    // Define the default values for all the connector.Similary we can add all the properties
    getConnectorDefaults = {
        (obj: ConnectorModel): ConnectorModel => {
            obj.type = 'Orthogonal'
            return obj;
        }
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Decorator appearance

The source decorator’s strokeColor, strokeWidth, and strokeDashArray properties are used to customize the color, width, and appearance of the decorator.
To set the border stroke color, stroke width, and stroke dash array for the target decorator, use strokeColor, strokeWidth, and strokeDashArray.
To set the size for source and target decorator, use width and height property.

The following code example illustrates how to customize the appearance of the decorator.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: "connector1",
type: 'Straight',
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
bridgeSpace: 20,
// Cutomize the target decorator
targetDecorator: {
    style: {
        // Fill color of the decorator
        fill: '#6BA5D7',
        // Stroke color of the decorator
        strokeColor: '#6BA5D7'
    }
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Interaction

Diagram allows to edit the connectors at runtime. To edit the connector segments at runtime, refer to Connection Editing.

Constraints

The constraints property of connector allows to enable/disable certain features of connectors.
To enable or disable the constraints, refer constraints.

The following code illustrates how to disable selection.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
DiagramConstraints,
ConnectorConstraints,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";
let connectors: ConnectorModel[] = [{
id: "connector1",
// Disables selection constraints
constraints: ConnectorConstraints.Default & ~ConnectorConstraints.Select,
type: 'Straight',
style: {
    strokeColor: '#6BA5D7',
    fill: '#6BA5D7',
    strokeWidth: 2
},
targetDecorator: {
    style: {
        fill: '#6BA5D7',
        strokeColor: '#6BA5D7'
    }
},
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}];
ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        1500
    }
    height = {
        1500
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Custom properties

The addInfo property of connectors allow you to maintain additional information to the connectors.

let connectors: ConnectorModel[] = [{
id: 'connector1',
// Defines the information about the connector
addInfo: 'centralconnector',
type: 'Straight',
sourceID: 'Transaction',
targetID: 'Verification'
}];

Stack order

The connectors zIndex property specifies the stack order of the connector. A connector with greater stack order is always in front of a connector with a lower stack order.

The following code illustrates how to render connector based on the stack order.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
ConnectorModel
} from "@syncfusion/ej2-react-diagrams";

let connectors: ConnectorModel[] = [{
id: 'connector1',
// Defines the z-index value for the connector
zIndex: 2,
type: 'Straight',
sourcePoint: {
    x: 300,
    y: 100
},
targetPoint: {
    x: 300,
    y: 200
}
}, {
id: 'connector2',
type: 'Straight',
// Defines the z-index value for the connector
zIndex: 1,
sourcePoint: {
    x: 100,
    y: 100
},
targetPoint: {
    x: 200,
    y: 200
}
}];

ReactDOM.render( <DiagramComponent     id="diagram"
    width = {
        '100%'
    }
    getConnectorDefaults = {
        (obj: ConnectorModel): ConnectorModel => {
            obj.style.strokeColor = '#6BA5D7';
            obj.style.fill = '#6BA5D7';
            obj.style.strokeWidth = 2;
            obj.targetDecorator.style.fill = '#6BA5D7';
            obj.targetDecorator.style.strokeColor = '#6BA5D7';
            return obj;
        }
    }
    height = {
        '600px'
    }
    connectors = {
        connectors
    }
    />,   document.getElementById("diagram") );

Line Routing

Line Routing is used to avoid the overlapping of nodes and connectors. Connectors are the most important elements of a diagram used to show the flow and relationship between shapes in the flowcharts, organizational charts, and hierarchy diagrams. Line Routing provides the flexibility to re-route the diagram connectors. A connector will frequently re-route itself when a shape moves next to it.

Note: You need to inject line routing module into the diagram. Line routing is applicable only for orthogonal segment of connector.

The following code illustrates how the automatic line routing is enabled for diagram.

Source

Preview

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import {
Diagram,
DiagramComponent,
Inject,
LineRouting,
DiagramConstraints,
ConnectorModel,
NodeModel,
} from "@syncfusion/ej2-react-diagrams";

//Initializes the nodes for the diagram
let nodes = [
  { id: 'shape1', offsetX: 100, offsetY: 100, width: 120, height: 50 },
  { id: 'shape2', offsetX: 300, offsetY: 300, width: 120, height: 50 },
  { id: 'shape3', offsetX: 150, offsetY: 200, width: 120, height: 50 }
];
//Initializes the connector for the diagram
let connectors = [
  { id: 'connector', sourceID: 'shape1', targetID: 'shape2', type: 'Orthogonal' }
];

ReactDOM.render( <DiagramComponent id="diagram" width={"100%"} height={"700px"}
            nodes = {
            nodes
            }
            connectors = {
            connectors
            }
          constraints = {
            DiagramConstraints.Default | DiagramConstraints.LineRouting
            }
          getNodeDefaults={(node) => {
            node = { style: { strokeColor: '#65B091', fill: '#65B091' } }
            return node;
          }}
          ><Inject services = {[LineRouting]}/>
        </DiagramComponent>,   document.getElementById("diagram") );

Connector in React Diagram component

Create connector

Add connectors through connectors collection

Add connector at runtime

Connectors from palette

Draw connectors

Update connector at runtime

Connect nodes

Connections with ports

Segments

Straight

Orthogonal

Avoid overlapping

Bezier

Decorator

Padding

Flip

Bridging

Corner radius

Appearance

Segment appearance

Decorator appearance

Interaction

Constraints

Custom properties

Stack order

Line Routing

See Also