Layer 更新与动态数据

在 MapboxOverlay 中更新 deck.gl Layer,理解稳定 id、data、accessor 和 updateTriggers。

🎯 引言

学完这篇文章,你能在不重建 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 之外的状态,就需要标记外部依赖。

🧪 小练习

  1. 把示例中的 selectedType 改成“普通”,观察颜色变化。
  2. 给 getRadius 增加 updateTriggers.getRadius,让半径依赖一个外部缩放系数。

🎉 现在你可以在保持地图不变的情况下更新 deck.gl 数据图层了。