拾取、点击、悬浮与 Tooltip

使用 deck.gl PickingInfo 处理图层点击和悬浮,并理解它与 Mapbox 地图事件的区别。

🎯 引言

学完这篇文章,你能让 deck.gl 图形响应点击和悬浮,拿到原始业务对象,并把结果同步到 Tooltip 或详情面板。

🧱 开启拾取

deck.gl 默认只负责绘制。图层设置 pickable: true 后,deck.gl 才会为图形建立拾取信息,onClick 和 onHover 才能知道用户指向了哪条数据。

const layer = new ScatterplotLayer({
    id: 'stations',
    data: stations,
    pickable: true,
    getPosition: (station) => [station.lng, station.lat],
    getRadius: 500,
    getFillColor: [37, 99, 235, 220],
    onClick: (info) => {
        console.log(info.object);
    },
    onHover: (info) => {
        console.log(info.object);
    },
});

overlay.setProps({ layers: [layer] });

🔎 认识 PickingInfo

PickingInfo 是 deck.gl 交给事件回调的信息对象,常用字段包括:

  • object:被拾取的原始业务数据。
  • index:该数据在 data 中的下标。
  • coordinate:鼠标位置对应的地理坐标。
  • x、y:事件发生时的屏幕像素位置。

object 是把图形和业务详情连接起来的关键。拿到它之后,可以更新 Vue 状态、筛选侧边栏或请求详情接口。

💡 Tooltip 与详情面板

临时悬浮提示可以使用 Overlay 的 getTooltip,固定的业务详情则可以在 onClick 中更新页面状态:

const overlay = new MapboxOverlay({
    interleaved: true,
    getTooltip: ({ object }) => object && {
        html: `<strong>${object.name}</strong><br>数量:${object.count}`,
    },
    layers: [layer],
});

getTooltip 适合快速查看,详情面板适合展示更完整的信息。需要固定在地图坐标上的信息窗口时,也可以把 PickingInfo.coordinate 交给 Mapbox Popup;这和 deck.gl 自己的 Tooltip 是两种展示方式。

下面的示例同时展示悬浮提示、点击详情和原始业务数据:

悬浮一个点查看 Tooltip,点击一个点查看详情
点击任意点,详情面板会显示它的原始业务数据

⚡ Mapbox 事件与 deck.gl 事件

页面中同时存在两套事件系统:

deck.gl Layer:onClick、onHover,负责图形拾取
Mapbox Map:click、mousemove、move、zoomend,负责地图和相机

点击一个 deck.gl 点时使用 Layer 的 onClick;监听用户完成缩放时使用 map.on('zoomend')。不要把地图移动事件和图形拾取事件混在一起处理。

🧾 小节总结

  • pickable: true 是图层响应拾取的前提。
  • PickingInfo.object 可以拿到原始业务数据。
  • onHover 适合悬浮提示,onClick 适合选中和详情面板。
  • Mapbox 事件管理地图,deck.gl 事件管理图形。

❓ 知识问答

Q1:为什么 onClick 没有拿到 object?

先检查图层是否设置了 pickable: true,再确认点击位置确实落在图形上。

Q2:Tooltip 应该用 Mapbox Popup 还是 deck.gl Tooltip?

悬浮查看通常使用 deck.gl Tooltip,点击后固定在地理位置上的窗口可以使用 Mapbox Popup。

Q3:coordinate 和 object.position 有什么区别?

object.position 是业务数据里的坐标,coordinate 是这次鼠标事件对应的地图坐标,两者用途不同。

🧪 小练习

  1. 在 onClick 中把 info.object 的 status 显示到详情面板。
  2. 修改 getFillColor,让被选中的点使用另一种颜色。

🎉 现在你可以把地图上的图形和业务交互连接起来了。