g6/packages/site/docs/apis/data/EdgeModel.en.md
2023-11-10 18:43:02 +08:00

4.1 KiB

title order
EdgeModel 8

EdgeModel represents the edge data that is internally passed through the EdgeUserModel and transformed on the graph instance. You consume this data anywhere afterwards. Each edge item extends from EdgeUserModel and is defined as follows after expansion:

interface EdgeModel {
  id: string | number;
  source: string | number;
  target: string | number;
  data: EdgeModelData; // = EdgeModelData
}

id

The unique ID of the edge. Once the node is created, the ID cannot be modified.

  • Required: True;
  • Type: string|number

source

The ID of the source node of the edge, which should correspond to an item in nodes. Otherwise, the edge data will not be added to the graph.

  • Required: True;
  • Type: string|number

target

The ID of the target node of the edge, which should correspond to an item in nodes. Otherwise, the edge data will not be added to the graph.

  • Required: True;
  • Type: string|number

data

The data in InnerModelData is the result of UserModelData transformed through a series of transform functions on the Graph instance. The business data may have been converted, filtered, and merged.

  • Required: True;
  • Type: EdgeModelData, same as EdgeModelData as follows:

EdgeModelData.type

The rendering type of the edge, which can be a registered edge type on the graph, with the built-in and default registered types being 'line-edge' and 'loop-edge'. The default value is 'line-edge'.

  • Required: False;
  • Type: string;

EdgeModelData.visible

Whether the edge is displayed by default.

  • Required: False;
  • Type: boolean;

EdgeModelData.color

The theme color of the main shape (keyShape) of the edge, with a value in hexadecimal string format. This is provided for convenient simple configuration, and more style configurations should be configured in the edge mapper of the Graph instance for the keyShape and various shape styles.

  • Required: False;
  • Type: string;

EdgeModelData.label

The text content of the labelShape of the edge. This is provided for convenient simple configuration, and more style configurations should be configured in the edge mapper of the Graph instance for the text value or other shape styles of the labelShape.

  • Required: False;
  • Type: string;

EdgeModelData.badge

The configuration of the badge on the edge, with the built-in badge being drawn after the text. More style configurations should be configured in the edge mapper of the Graph instance for the shape styles of the badgeShapes.

  • Required: False;
  • Type:
{
  position: BadgePosition,
  type: 'text' | 'icon',
  img?: string, // required when type is 'text'
  text?: string, // required when type is 'icon'
};

EdgeModelData.icon

The configuration of the icon on the edge. The built-in edge icon is drawn after the text. This is provided for convenient simple configuration, and more style configurations should be configured in the edge mapper of the Graph instance for the shape styles of the iconShape.

  • Required: False;
  • Type:
{
  type: 'text' | 'icon',
  img?: string, // required when type is 'text'
  text?: string, // required when type is 'icon'
}

EdgeModelData.sourceAnchor

The anchorPoints on the source node indicate the allowed positions where related edges can connect, and is an array. The sourceAnchor of the edge indicates which anchor point to connect to when the edge connects to the starting point, corresponding to the index of the corresponding position in the anchorPoints of the source node.

  • Required: False;
  • Type: number;

EdgeModelData.targetAnchor

The anchorPoints on the target node indicate the allowed positions where related edges can connect, and is an array. The targetAnchor of the edge indicates which anchor point to connect to when the edge connects to the ending point, corresponding to the index of the corresponding position in the anchorPoints of the target node.

  • Required: False;
  • Type: number;