拾取、点击、悬浮与 Tooltip
🎯 引言
学完这篇文章,你能让 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 是两种展示方式。
下面的示例同时展示悬浮提示、点击详情和原始业务数据:
⚡ 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 是这次鼠标事件对应的地图坐标,两者用途不同。
🧪 小练习
- 在
onClick中把info.object的status显示到详情面板。 - 修改
getFillColor,让被选中的点使用另一种颜色。
🎉 现在你可以把地图上的图形和业务交互连接起来了。
