Vico图表库中CartesianMarkerVisibilityListener.onShown重复调用问题解析

问题背景

在Vico图表库从1.16.0版本升级到2.0.1版本后，用户反馈了一个关于标记(Marker)显示行为的异常问题。具体表现为：当用户点击图表项时，原本应该永久显示的标记有时会短暂出现后消失，有时又能正常持久显示。这种不一致的行为影响了用户体验。

问题本质

经过分析，问题的核心在于CartesianMarkerVisibilityListener.onShown方法在CartesianChart被复制时会重新被调用。这导致了标记显示状态的意外重置，从而出现了标记短暂显示后又消失的现象。

技术细节

在Vico 2.0.1版本中，当使用以下组合时会出现此问题：

1. 使用CartesianMarkerVisibilityListener监听标记显示事件
2. 通过persistentMarkers实现持久标记
3. 在标记显示回调中修改状态来控制标记的持久性

问题的根本原因是图表在内部处理过程中会创建副本，而这个过程意外触发了标记显示监听器的重新调用，导致状态管理出现混乱。

解决方案

Vico团队已经分别在两个版本中修复了这个问题：

1. 在2.0.3版本中提供了针对性的修复
2. 在2.1.0 Beta 1版本中进一步优化了相关逻辑

最佳实践建议

对于需要在用户交互后保持标记显示的场景，建议采用以下模式：

1. 使用rememberMarker()创建标记实例
2. 通过状态管理标记的持久显示位置
3. 在persistentMarkers中根据状态渲染标记
4. 在CartesianMarkerVisibilityListener中更新状态

这种模式可以确保标记的显示行为符合预期，不受内部图表复制操作的影响。

升级建议

对于遇到此问题的用户，建议升级到Vico 2.0.3或更高版本。如果项目允许使用测试版，也可以考虑使用2.1.0 Beta 1版本，该版本包含了更多改进和优化。

总结

Vico图表库在2.x版本中对标记系统进行了重构，带来了更强大的功能，但也引入了一些需要适应的行为变化。通过理解这些内部机制并遵循推荐的最佳实践，开发者可以充分利用新版本的特性，同时避免潜在的问题。