GoJS中Link.suspendsRouting属性的使用与注意事项

背景介绍

GoJS是一款功能强大的JavaScript图表库，广泛应用于构建交互式图表和可视化工具。在GoJS 2.x版本中，存在一个未公开的属性Link.suspendsRouting，该属性在某些特定场景下非常有用，但在3.0.4版本中被移除了。

Link.suspendsRouting属性解析

Link.suspendsRouting是一个布尔属性，当设置为true时，会临时阻止链接(Link)的自动路由计算。这在需要临时修改链接路径或显示工具提示等场景下非常有用。

典型使用场景

1. 工具提示展示：当鼠标悬停在链接上时显示工具提示，而不触发链接的重新路由
2. 临时路径修改：在用户交互过程中临时修改链接路径
3. 性能优化：在批量操作时暂时禁用路由计算

版本兼容性问题

在GoJS 3.0.4版本中，这个未公开的属性被移除了，导致一些依赖此功能的应用程序无法正常工作。开发团队在收到反馈后，决定在3.0.6及以后的版本中重新加入此属性。

使用注意事项

虽然Link.suspendsRouting功能强大，但使用时需要特别注意：

1. 及时重置：使用后必须记得将属性重置为false，否则会导致链接路由功能永久失效
2. 性能影响：滥用此属性可能导致图表布局问题
3. 替代方案：对于简单的工具提示需求，可以考虑使用Adornment装饰器

最佳实践建议

1. 仅在必要时使用此属性，并确保在finally块中重置
2. 对于简单的UI交互，优先考虑使用Adornment等官方支持的方式
3. 在复杂场景下，可以考虑自定义路由逻辑而非依赖此属性

结论

Link.suspendsRouting是一个强大但需要谨慎使用的功能。GoJS团队虽然将其恢复，但仍保持其未公开状态，这意味着它可能在未来的版本中再次发生变化。开发者在使用时应充分评估风险，并考虑更稳定的替代方案。