Layer 更新与动态数据
🎯 引言
学完这篇文章,你能在不重建 Mapbox 地图的情况下更新 deck.gl 数据、样式和筛选结果。
🧱 为什么通常重新创建 Layer
deck.gl 的 Layer 配置是声明式对象。我们描述“当前应该绘制什么”,deck.gl 比较新旧配置后复用可以复用的 GPU 资源。因此,数据变化时通常重新创建 Layer 实例,而不是直接修改旧实例里的字段。
function updateLayers(data) {
const layer = new ScatterplotLayer({
id: 'stations',
data,
getPosition: (item) => [item.lng, item.lat],
getRadius: (item) => item.value,
});
overlay.setProps({
layers: [layer],
});
}
这里更新的是 deck.gl Overlay 的图层列表,Mapbox 地图、底图和 Camera 都不需要重建。
🔁 data 与 accessor 更新
如果 accessor 只依赖当前 data 项,替换 data 后重新创建 Layer 通常就足够:
const layer = new ScatterplotLayer({
id: 'events',
data: nextData,
getPosition: (item) => item.position,
getRadius: (item) => item.level * 8,
});
overlay.setProps({ layers: [layer] });
如果 accessor 还依赖 data 之外的状态,就需要使用 updateTriggers 告诉 deck.gl 哪些外部值变化时要重新执行 accessor:
const selectedType = '重点';
const layer = new ScatterplotLayer({
id: 'events',
data,
getPosition: (item) => item.position,
getFillColor: (item) => item.type === selectedType
? [220, 38, 38, 220]
: [37, 99, 235, 180],
updateTriggers: {
getFillColor: [selectedType],
},
});
updateTriggers.getFillColor 中的数组就是 getFillColor 的外部依赖列表。selectedType 变化时,deck.gl 会重新计算颜色属性;如果漏掉这个依赖,颜色可能仍然停留在旧结果。
⚡ 什么时候会重新计算 GPU 属性
可以把常见情况分成三类:
data换了,依赖数据项的 accessor 需要重新计算。- accessor 的外部状态换了,需要通过
updateTriggers标记。 - Layer 的 id、图层类型或关键配置变化,deck.gl 会重新组织对应资源。
下面的示例把筛选和样式更新交给 MapboxOverlay,Mapbox 底图不会被重新创建:
🪤 稳定 id 与生命周期
Vue 的 ref、computed 和 watch 只负责组织状态。状态变化后生成新的 Layer 数组,再调用 overlay.setProps({ layers }) 即可。组件卸载时销毁 Mapbox 地图和 Overlay,避免留下事件监听器和 WebGL 资源。
🧾 小节总结
- Layer 更新是声明式的,通常重新创建配置而不是修改旧实例。
- 稳定的
id让 deck.gl 识别前后对应的图层。 - 只依赖 data 项时,替换 data 通常就够了。
- accessor 依赖外部状态时,需要使用
updateTriggers。 - 更新 deck.gl 图层不需要重建 Mapbox 地图。
❓ 知识问答
Q1:每次数据更新都要销毁 MapboxOverlay 吗?
不需要。保留 Overlay,只通过 overlay.setProps 更新 layers。
Q2:updateTriggers 会更新什么?
它会让指定 accessor 重新计算对应的 GPU 属性,例如颜色、半径或透明度。
Q3:data 换了还要写 updateTriggers 吗?
如果 accessor 只读取当前 data 项,通常不需要;如果还读取 data 之外的状态,就需要标记外部依赖。
🧪 小练习
- 把示例中的
selectedType改成“普通”,观察颜色变化。 - 给
getRadius增加updateTriggers.getRadius,让半径依赖一个外部缩放系数。
🎉 现在你可以在保持地图不变的情况下更新 deck.gl 数据图层了。
