在使用 Highcharts 的 dumbbell 图表时，若同一 x 轴类别（category）下存在多个数据点，默认情况下仅会触发一个 tooltip。其根本原因在于findNearestPointBy参数默认值为'x'；将其修改为'xy'即可实现多数据点的精准悬停提示。
在日常数据可视化开发中，Highcharts 的 dumbbell 图表是一款非常实用的工具，尤其适合展示两组数据之间的范围变化。然而，开发者经常遇到一个典型问题：当同一个 x 轴类别下包含多个数据点时，鼠标悬停时 tooltip 始终只显示第一个点的信息，其余数据点仿佛“隐身”一般。这个“悬停失效”的根源，实际上隐藏在 Highcharts 默认的交互策略中。
简而言之，dumbbell 图形本质上是一种基于范围（range）的系列类型，每个数据点由 low 和 high 两个数值定义，通常配合类别轴（如 "type": "category"）使用。当多个 dumbbell 数据点共享同一个 x 轴类别——例如本例中 "name": "Test1" 出现了两次——Highcharts 默认采用 findNearestPointBy: 'x' 策略。这意味着系统仅根据 x 坐标来查找最近点，完全忽略 y 方向的差异。结果就是：鼠标在同一个 category 区域内移动时，系统始终锚定“第一个匹配点”，其余重叠或并列的 dumbbell 线段根本无法触发 tooltip。
解决思路其实非常直接：
"series": [{
"type": "dumbbell",
"name": "Test",
"findNearestPointBy": "xy", // ← 关键修复项
"data": [
{ "name": "Test1", "low": 1658882324000, "high": 1699267066000, "v": "A" },
{ "name": "Test1", "low": 1681067066000, "high": 1739067066000, "v": "B" },
// ...
],
// 其他配置...
}]
将 findNearestPointBy 设置为 'xy' 后，系统会启用二维距离计算（欧氏距离），确保 tooltip 始终响应离鼠标位置最近的数据点——无论它们是否属于同一个 category。这才是真正的“所见即所得”。
不过，有几个细节需要特别留意：
- 该选项适用于所有支持
findNearestPointBy的 Highcharts 系列类型（包括 dumbbell、lollipop、range 等），但必须注意：不能全局设置在plotOptions.series中。必须在每个具体的 series 内声明，否则可能被继承覆盖或失效。 - 如果图表启用了
shared: true的 tooltip，findNearestPointBy依然需要设为'xy'，否则 shared 模式会退化为仅显示单点，完全达不到聚合展示的效果。 - 时间戳数据（比如本例中的毫秒级 Unix 时间）最好配合
yAxis.labels.format和tooltip.pointFormat中的dateFormat或Highcharts.dateFormat()使用，确保日期格式一致且可读。
此外，还可以进一步优化交互体验：启用 tooltip.followPointer: true，或者自定义 tooltip.formatter 实现多点聚合展示（例如列出同一 category 下所有匹配点）。但核心前提始终是 findNearestPointBy: 'xy' 的正确配置——没有这个基础，其他优化都是空中楼阁。
修复之后，悬停任意 dumbbell 线段都可以准确触发对应 point.v、point.low 和 point.high 的格式化提示，真正做到“指哪打哪”。希望这篇文章能帮你一次性搞定这个交互细节。
