Billboard.js 数据名称在图例工具提示中的显示问题解析

在数据可视化库Billboard.js的使用过程中，开发者可能会遇到一个关于数据名称显示的细节问题：当使用data.names属性为数据列定义友好名称时，图例文本能正确应用格式化函数显示简称，但悬停工具提示却仍然显示原始标识符而非友好名称。

问题现象

通过配置data.names对象，开发者可以为数据列指定更易读的显示名称。例如将原始标识符"data"映射为"Detailed Name"。在图例格式化函数中，可以对这个友好名称进行截断处理（如显示为"De..."），但此时图例的悬停工具提示却会回退显示原始标识符"data"，造成显示不一致。

技术原理

这个问题的本质在于图例工具提示的逻辑处理层级。在Billboard.js的内部实现中：

1. 图例文本渲染时会完整调用开发者定义的legend.format函数，并传入经过data.names转换后的友好名称
2. 但工具提示系统直接使用了数据列的原始标识符作为查找键，没有经过相同的名称转换和格式化流程

解决方案

该问题已在最新版本中得到修复。现在工具提示系统会：

1. 先通过data.names将原始标识符转换为友好名称
2. 再将转换后的名称传递给legend.format函数进行处理
3. 最终显示与图例文本保持一致的格式化结果

最佳实践

对于需要自定义数据显示的场景，建议开发者：

1. 始终通过data.names定义友好名称而非直接修改原始数据标识符
2. 在legend.format函数中实现统一的显示逻辑
3. 对于复杂的格式化需求，可以考虑扩展默认的tooltip行为

这个问题修复体现了Billboard.js对数据可视化一致性的重视，确保用户在交互过程中的每个细节都能获得统一的视觉反馈。对于使用较旧版本的开发者，升级到最新版本即可获得完整的修复体验。