Styling relationships

By default, all relationships are rendered as dashed grey lines as shown in the example diagram below.

However, the following characteristics of the relationships can be customized:

Line thickness (pixels)
Colour (HTML hex value)
Dashed (true or false)
Routing (Direct or Orthogonal; see the Routing enum)
Font size (pixels)
Width (of the description, in pixels)
Position (of the description along the line, as a percentage from start to end)
Opacity (an integer between 0 and 100)

Tagging relationships

All relationships within a software architecture model can have one or more tags associated with them. A tag is simply a free-format string. By default, the Java client library adds the "Relationship" tag to relationships. As we'll see shortly, you can add your own custom tags to relationships using the addTags() method on the relationship.

Colour

To style a relationship, simply create a RelationshipStyle for a particular tag and specify the characteristics that you would like to change. For example, you can change the colour of all relationships as follows.

Styles styles = workspace.getViews().getConfiguration().getStyles();
styles.addRelationshipStyle(Tags.RELATIONSHIP).color("#ff0000");

You can also change the colour of specific relationships, based upon their tag, as follows.

model.getRelationships().stream().filter(r -> "HTTPS".equals(r.getTechnology())).forEach(r -> r.addTags("HTTPS"));
model.getRelationships().stream().filter(r -> "JDBC".equals(r.getTechnology())).forEach(r -> r.addTags("JDBC"));
styles.addRelationshipStyle("HTTPS").color("#ff0000");
styles.addRelationshipStyle("JDBC").color("#0000ff");

Diagram key

Structurizr will automatically add all relationship styles to a diagram key.

You can find the code for this example at StylingRelationships.java and the live example workspace at https://structurizr.com/share/36131.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly