Relation-Graph 中节点展开/收起时忽略虚线连接的配置方法

背景介绍

在关系图可视化工具 Relation-Graph 中，节点之间的连接线（边）不仅用于展示节点间关系，还参与布局计算和交互逻辑。默认情况下，所有连接线（包括虚线）都会影响节点的展开/收起行为以及力学布局中的牵引力计算。

问题场景

在实际应用中，我们有时会使用虚线来表示某种特殊关系（如潜在关系、次要关系等），希望这些虚线连接仅作为视觉展示，不影响节点的层级关系和布局计算。特别是在节点展开/收起功能中，不希望虚线连接被识别为正式的上下级关系。

解决方案

Relation-Graph 提供了 line.forDisplayOnly 属性来解决这一问题。该属性默认值为 false，表示连接线既用于展示也参与计算。当设置为 true 时，该连接线将：

1. 仅作为视觉展示元素
2. 不参与上下级关系计算
3. 在力学布局中不产生牵引力

实现方式

要为特定连接线启用仅展示模式，可以在定义连接关系时设置：

{
  from: '节点A',
  to: '节点B',
  text: '次要关系',
  lineStyle: {
    strokeDasharray: '5,5',  // 虚线样式
    forDisplayOnly: true     // 关键配置
  }
}

应用场景

这种配置特别适用于以下情况：

1. 需要区分主要关系和次要关系的场景
2. 展示潜在关系或推测关系时
3. 需要添加辅助说明线但不影响实际布局时
4. 实现特殊视觉效果但保持原有节点交互逻辑

注意事项

1. 该属性是连接线级别的配置，可以针对每条连接线单独设置
2. 设置为仅展示的连接线不会影响节点的展开/收起状态
3. 在复杂布局中，合理使用此功能可以优化视觉呈现效果
4. 该配置不会影响连接线的其他样式属性设置

通过合理使用 forDisplayOnly 属性，开发者可以更灵活地控制关系图的展示效果和交互行为，实现更符合业务需求的视觉效果。