Link Connection Points on Nodes

There is flexibility in controlling exactly how and where a link connects to a node. In the previous examples the link has always ended at the edge of the node. But you can specify the Spot on a node at which a link terminates.

Non-rectangular Nodes

When a Node does not have a rectangular shape, by default links will end where the line toward the center of the node intersects with the edge of the node.

Here is a demonstration of that -- drag one of the nodes around and watch how the link always connects to the nearest intersection or to the center of the node. This example includes arrowheads at both ends of the link, to make it clear that the link route really ends right at the edge of the node.


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { width: 90, height: 90,
        selectionAdorned: false },
      new go.Binding("location", "loc", go.Point.parse),
      $(go.Shape, "FivePointedStar", { fill: "lightgray" }),
      $(go.TextBlock,
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      $(go.Shape),
      $(go.Shape,   // the "from" end arrowhead
        { fromArrow: "Chevron" }),
      $(go.Shape,   // the "to" end arrowhead
        { toArrow: "StretchedDiamond", fill: "red" })
    );

  var nodeDataArray = [
    { key: "Alpha", loc: "0 0" },
    { key: "Beta", loc: "100 50" }
  ];
  var linkDataArray = [
    { from: "Alpha", to: "Beta" }
  ];
  diagram.model = new go.GraphLinksModel(nodeDataArray, linkDataArray);

ToSpot and FromSpot

You can easily require links to end at a particular point within the bounds of the node, rather than at the nearest edge intersection. Set the GraphObject.toSpot to a Spot value other than Spot,None to cause links coming into the node to end at that spot within the node, with a direction that is appropriate for the side that the spot is at. Similarly, set the GraphObject.fromSpot for the ends of links coming out of the node.

The following examples all display the same graph but use different templates to demonstrate how links can connect to nodes. They all call this common function to define some nodes and links.


function makeGraph(diagram) {
  var $ = go.GraphObject.make;

  diagram.layout =
    $(go.LayeredDigraphLayout,  // this will be discussed in a later section
      {
        columnSpacing: 5,
        setsPortSpots: false,
        alignOption: go.LayeredDigraphLayout.AlignAll
      });

  var nodeDataArray = [
    { key: "Alpha" }, { key: "Beta" }, { key: "Gamma" }, { key: "Delta" },
    { key: "Epsilon" }, { key: "Zeta" }, { key: "Eta" }, { key: "Theta" }
  ];
  var linkDataArray = [
    { from: "Beta", to: "Alpha" },
    { from: "Gamma", to: "Alpha" },
    { from: "Delta", to: "Alpha" },
    { from: "Alpha", to: "Epsilon" },
    { from: "Alpha", to: "Zeta" },
    { from: "Alpha", to: "Eta" },
    { from: "Alpha", to: "Theta" }
  ];
  diagram.model = new go.GraphLinksModel(nodeDataArray, linkDataArray);
}

Let us specify that links coming into a node connect at the middle of the left side, and that links going out of a node connect at the middle of the right side. Such a convention is appropriate for diagrams that have a general sense of direction to them, such as the following one which goes from left to right.


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { fromSpot: go.Spot.Right,  // coming out from middle-right
        toSpot: go.Spot.Left },   // going into middle-left
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  makeGraph(diagram);

You can also specify that the links go into a node not at a single spot but spread out along one side. Instead of Spot,Right use Spot,RightSide, and similarly for the left side.


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { fromSpot: go.Spot.RightSide,  // coming out from right side
        toSpot: go.Spot.LeftSide },   // going into left side
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  makeGraph(diagram);

Of course this only looks good when the nodes are basically rectangular.

You can use a different kind of Link.routing:


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { fromSpot: go.Spot.RightSide,  // coming out from right side
        toSpot: go.Spot.LeftSide },   // going into left side
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      { routing: go.Link.Orthogonal,  // Orthogonal routing
        corner: 10 },                 // with rounded corners
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  makeGraph(diagram);

Or you can use a different kind of Link.curve:


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { fromSpot: go.Spot.RightSide,  // coming out from right side
        toSpot: go.Spot.LeftSide },   // going into left side
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      { curve: go.Link.Bezier },  // Bezier curve
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  makeGraph(diagram);

But you need to be careful to specify sensible spots for how the graph is arranged.


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      { fromSpot: go.Spot.TopSide,    // coming out from top side -- BAD!
        toSpot: go.Spot.RightSide },  // going into right side -- BAD!
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  makeGraph(diagram);

  diagram.add($(go.Part,  // this is just a comment
                { location: new go.Point(300, 50) },
                $(go.TextBlock, "Bad Spots",
                  { font: "16pt bold", stroke: "red" })
              ));

Undirected Spots

When no spot is specified for the GraphObject.fromSpot or GraphObject.toSpot, the route computation will compute the furthest point on the route of the link from the center of the port to the other port that is an intersection of an edge of the port. This was demonstrated above in Non-rectangular Nodes and is again demonstrated here.


  diagram.nodeTemplate =
    $(go.Node, "Vertical",
      new go.Binding("location", "loc", go.Point.parse),
      $(go.Shape, "YinYang",
        {
          fill: "white", portId: ""
        },
        new go.Binding("fill", "color")),
      $(go.TextBlock,
        { margin: 8 },
        new go.Binding("text"))
    );

  diagram.model = new go.GraphLinksModel(
    [
      { key: 1, text: "Alpha", color: "lightblue", loc: "0 50" },
      { key: 2, text: "Beta", color: "orange", loc: "150 0" },
      { key: 3, text: "Gamma", color: "lightgreen", loc: "300 50" }
    ],
    [
      { from: 1, to: 2 },
      { from: 2, to: 3 }
    ]);

However it is possible to specify a focus point that is different from the center of the port. Use a Spot value that has Spot.x and Spot.y equal to 0.5 but with Spot.offsetX and Spot.offsetY values that specify where you want links to focus towards, relative to the center of the port.


  diagram.nodeTemplate =
    $(go.Node, "Vertical",
      new go.Binding("location", "loc", go.Point.parse),
      $(go.Shape, "YinYang",
        {
          fill: "white", portId: "",
          fromSpot: new go.Spot(0.5, 0.5, 0, -25), toSpot: new go.Spot(0.5, 0.5, 0, 25)
        },
        new go.Binding("fill", "color")),
      $(go.TextBlock,
        { margin: 8 },
        new go.Binding("text"))
    );

  diagram.model = new go.GraphLinksModel(
    [
      { key: 1, text: "Alpha", color: "lightblue", loc: "0 50" },
      { key: 2, text: "Beta", color: "orange", loc: "150 0" },
      { key: 3, text: "Gamma", color: "lightgreen", loc: "300 50" }
    ],
    [
      { from: 1, to: 2 },
      { from: 2, to: 3 }
    ]);

In this example, links always appear to be coming from the hole near the top of the "YinYang" figure towards the dot near the bottom of the figure. Try moving the nodes to see this behavior. Note that the Spot.x and Spot.y values are both 0.5, with fixed offsets from the center of the port.

It is also possible to have links go directly to particular spots within a port. Use regular Spot values, but set the Link's end segment length to zero, Link.fromEndSegmentLength or Link.toEndSegmentLength.


  diagram.nodeTemplate =
    $(go.Node, "Vertical",
      new go.Binding("location", "loc", go.Point.parse),
      $(go.Shape, "YinYang",
        {
          fill: "white", portId: "",
          fromSpot: new go.Spot(0.5, 0.25), toSpot: new go.Spot(0.5, 0.75),
          fromEndSegmentLength: 0, toEndSegmentLength: 0
        },
        new go.Binding("fill", "color")),
      $(go.TextBlock,
        { margin: 8 },
        new go.Binding("text"))
    );

  diagram.model = new go.GraphLinksModel(
    [
      { key: 1, text: "Alpha", color: "lightblue", loc: "0 50" },
      { key: 2, text: "Beta", color: "orange", loc: "150 0" },
      { key: 3, text: "Gamma", color: "lightgreen", loc: "300 50" }
    ],
    [
      { from: 1, to: 2 },
      { from: 2, to: 3 }
    ]);

Again, links always appear to be coming from the hole near the top of the "YinYang" figure towards the dot near the bottom of the figure, but now they go all the way rather than stop at the edge. Note that the Spot.x and Spot.y values are not both 0.5, and that the Link end segment lengths are zero.

Setting the GraphObject.fromSpot and GraphObject.toSpot properties specifies the default link connection point for all links connected to the node. What if you want some links to go to the middle-top spot but some other links to go to the middle-left spot of the same node? You can achieve this by setting the Link.fromSpot and Link.toSpot properties, which take precedence over the correspondingly named properties of what the link connects with.


  diagram.nodeTemplate =
    $(go.Node, "Auto",
      $(go.Shape, "Rectangle", { fill: "lightgray" }),
      $(go.TextBlock,
        { margin: 5},
        new go.Binding("text", "key"))
    );

  diagram.linkTemplate =
    $(go.Link,
      // get the link spots from the link data
      new go.Binding("fromSpot", "fromSpot", go.Spot.parse),
      new go.Binding("toSpot", "toSpot", go.Spot.parse),
      $(go.Shape),
      $(go.Shape, { toArrow: "Standard" })
    );

  var nodeDataArray = [
    { key: "Alpha" }, { key: "Beta" }, { key: "Gamma" }, { key: "Delta" }
  ];
  var linkDataArray = [
    { from: "Alpha", to: "Beta", fromSpot: "TopRight", toSpot: "Left" },
    { from: "Alpha", to: "Gamma", fromSpot: "Left", toSpot: "Left" },
    { from: "Alpha", to: "Delta", fromSpot: "None", toSpot: "Top" }
  ];
  diagram.model = new go.GraphLinksModel(nodeDataArray, linkDataArray);

Some Layouts set Link Spots

Some of the predefined Layouts automatically set Link.fromSpot and Link.toSpot when the nature of the layout implies a natural direction. So, for example, a TreeLayout with a TreeLayout.angle == 90 will set each Link's fromSpot to be Spot,Bottom and each Link's toSpot to be Spot,Top.

You can disable the setting of Link spots for TreeLayout by setting TreeLayout.setsPortSpot and/or TreeLayout.setsChildPortSpot to false. For LayeredDigraphLayout, set LayeredDigraphLayout.setsPortSpots to false. For ForceDirectedLayout, set ForceDirectedLayout.setsPortSpots to false, although this is rarely needed.

GoJS