内置连线

内置连线包括以下几种。使用可见内置连线

line

普通折线，从起点依次连接若干控制点后到达终点。

字段	类型	默认值	描述
controlPoints	number[][]		可选，提供若干除起点和终点外的控制点，该折线将依次经过该点。

水平拐线，从起点到终点，按照横向、纵向、横向方式延伸，走势类似于Z字形的折线。

字段	类型	默认值	描述
ignoreControlPoints	boolean	false	vGraph 的布局算法可能会在连线上写入控制点，可以开启此配置强制忽略
styles.radius	number	5	转角的半径
styles.curvePosition	number	0.5	转角的 x 坐标插值
styles.curveOffset	number	0	转角的 x 坐标偏移像素值

垂直拐线，从起点到终点，按照纵向、横向、纵向方式延伸，走势类似于N字形的折线。

字段	类型	默认值	描述
ignoreControlPoints	boolean	false	vGraph 的布局算法可能会在连线上写入控制点，可以开启此配置强制忽略
styles.radius	number	5	转角的半径
styles.curvePosition	number	0.5	转角的 y 坐标插值
styles.curveOffset	number	0	转角的 y 坐标偏移像素值

自由拐线，从起点到终点可以自定义若干个控制点的拐线。

字段	类型	默认值	描述
controlPoints	number[][]		可选，提供若干除起点和终点外的控制点。若提供该信息，则忽略 styles.curvePosition
styles.radius	number		转角的半径，若提供该信息则忽略 styles.radian（使用半径的情况下，钝角和锐角的视觉呈现效果差异较大，因此不推荐使用radius）
styles.radian	number	10	转角的弧长
styles.curvePosition	number[][]		每个控制点相较于起点节点中心坐标和终点节点中心坐标的插值信息

二次贝塞尔曲线，除起点和终点之外，需要一个控制点。

字段	类型	默认值	描述
controlPoints	number[][]		可选，提供一个除起点和终点外的控制点。若提供该值，将自动忽略以下配置项。
styles.curveOffset	number	-20	控制点与该向量的垂直距离
styles.curvePosition	number	0.5	控制点与该向量的垂线交点在该向量上的插值

三次贝塞尔曲线，该曲线将由P0，P1，P2，P3四个点决定，除起点P0和终点P3之外，需要两个控制点P1，P2。

字段	类型	默认值	描述
controlPoints	number[][]		可选，提供两个除起点和终点外的控制点。若提供该值，将自动忽略以下配置项。
styles.curveOffset	number[]	[-20, 20]	每个控制点与该向量的垂直距离
styles.curvePosition	number[]	[0.5, 0.5]	每个控制点与该向量的垂线交点在该向量上的插值

水平三次贝塞尔曲线，其中P1的y坐标与起点P0一致，P2的y坐标与终点P3一致。

字段	类型	默认值	描述
styles.curvePosition	number	[0.5, 0.5]	P1与P2在起点与终点内x坐标的插值

垂直三次贝塞尔曲线，其中P1的x坐标与起点P0一致，P2的x坐标与终点P3一致。

字段	类型	默认值	描述
styles.curvePosition	number	[0.5, 0.5]	P1与P2在起点与终点内y坐标的插值

自环，是节点指向其自身的连线。vgraph 提供三种类型的自环样式可定义。

字段	类型	默认值	描述
loop.theme	string	default	自环类型。可选的有 'default' \| 'round' \| 'arc'
loop.position	string	top	自环的位置。可选的有 'top' \| 'bottom' \| 'left' \| 'right'
loop.dist	number	auto	自环最高点和节点的距离。