You need to enable JavaScript to run this app. BoxSeries3D 如何实现鼠标悬停显示箱体数据及绑定点击事件
优惠活动
大模型
产品
解决方案
定价
更多

BoxSeries3D 如何实现鼠标悬停显示箱体数据及绑定点击事件

BoxSeries3D 交互无响应原因与实现方案

为啥你直接在BoxSeries3D上绑onMouseClick完全没反应

  • 3D图表的事件分发和2D逻辑完全不是一套:BoxSeries3D是纯渲染逻辑对象,根本没有对应DOM节点,你给它绑的DOM级鼠标事件,连触发源都找不到,自然不会有任何响应。
  • 3D场景的图元拾取走独立的射线检测通道,所有命中判定、事件回调都是由SciChart3DSurface全局统一调度,不会像2D那样把事件冒泡到单个Series实例上,之前的绑定方式从根上就走不通。

实现悬停提示、点击选箱体的正确步骤

  1. 先把拾取开关全开
    • 给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;
      
  2. 把事件绑在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 07:06:09