BoxSeries3D 如何实现鼠标悬停显示箱体数据及绑定点击事件
BoxSeries3D 交互无响应原因与实现方案
为啥你直接在BoxSeries3D上绑onMouseClick完全没反应
- 3D图表的事件分发和2D逻辑完全不是一套:
BoxSeries3D是纯渲染逻辑对象,根本没有对应DOM节点,你给它绑的DOM级鼠标事件,连触发源都找不到,自然不会有任何响应。 - 3D场景的图元拾取走独立的射线检测通道,所有命中判定、事件回调都是由
SciChart3DSurface全局统一调度,不会像2D那样把事件冒泡到单个Series实例上,之前的绑定方式从根上就走不通。
实现悬停提示、点击选箱体的正确步骤
- 先把拾取开关全开
- 给3D Surface实例设
isPickable = true,同时把viewportManager的拾取半径调到10-15像素——3D场景下鼠标操作精度比2D低,半径太小会频繁出现明明指着箱体却没命中的问题 - 给目标
BoxSeries3D单独设isPickable = true,别只开Surface的开关,单个系列关了拾取的话,射线检测直接跳过这个系列的所有箱体 - 参考配置代码:
// 3D Surface 基础配置 sciChart3DSurface.isPickable = true; sciChart3DSurface.viewportManager.pickRadius = 12; // 箱线图系列配置 boxSeries3D.isPickable = true;
- 给3D Surface实例设
- 把事件绑在Surface上,别绑在Series上
- 交互逻辑全部挂在
SciChart3DSurface的onMouseMove、onMouseClick回调里,用内置的hitTest接口拿当前命中的图元,别再往单个Series上塞事件 - 回调里一定要加类型筛选:3D场景里坐标轴、其他系列的图元都可能被命中,只有确认命中的是
BoxSeries3D的箱体,才执行对应的交互逻辑 - 参考实现:
// 悬停提示逻辑,和2D的tooltip体验对齐 sciChart3DSurface.onMouseMove = (mouseArgs) => { // 执行3D射线拾取 const hitResult = sciChart3DSurface.viewportManager.hitTest(mouseArgs.mousePosition); // 筛选有效命中:必须是BoxSeries3D的图元 if (hitResult?.isHit && hitResult.series instanceof BoxSeries3D) { // 拿到当前鼠标指向的完整箱体数据 const hoveredBox = hitResult.dataPoint; // 用内置方法把3D坐标转成屏幕坐标,定位自定义tooltip const screenPos = sciChart3DSurface.worldToScreen(hoveredBox.position); // 填充tooltip内容:把箱体的极值、四分位值、标签等信息填进去 tooltipEl.style.transform = `translate(${screenPos.x}px, ${screenPos.y}px)`; tooltipEl.style.display = 'block'; } else { // 没命中就把tooltip藏起来 tooltipEl.style.display = 'none'; } } // 点击选中箱体逻辑 sciChart3DSurface.onMouseClick = (mouseArgs) => { const hitResult = sciChart3DSurface.viewportManager.hitTest(mouseArgs.mousePosition); if (hitResult?.isHit && hitResult.series instanceof BoxSeries3D) { // 这里直接拿到你需要的被点击的箱体对象 const selectedBox = hitResult.dataPoint; // 可以加个高亮反馈:比如给选中的箱体换个填充色,其他箱体降透明度 } }
- 交互逻辑全部挂在
容易踩的坑
- 别自己写坐标转换的逻辑,内置的
worldToScreen方法会自动处理相机旋转、缩放、平移后的坐标偏移,自己算的话转出来的tooltip位置肯定会偏。 - 如果hitTest一直返回空结果,先检查
BoxSeries3D的isPickable是不是真的开了,很多人只开了Surface的开关,忘了单个系列的配置。
内容的提问来源于stack exchange,提问作者2fours
相关产品推荐
相关产品推荐

