首页 / deck.gl / API 文档
Layer
先看结论
所有图层的基类。描述数据、访问器、拾取和更新判定规则。
new deck.Layer(props)
通用参数
| 参数 | 默认 | 说明 |
|---|---|---|
id | 自动生成 | 图层标识，更新时按它匹配并复用 |
data | [] | 数组或可迭代对象 |
visible | true | 关闭后跳过绘制与拾取 |
opacity | 1 | 整体透明度，与颜色自带的 alpha 相乘 |
pickable | false | 是否参与拾取，拾取要多渲染一遍 |
autoHighlight | false | 悬停自动高亮 |
highlightColor | 蓝色 | 高亮叠加色 |
updateTriggers | {} | 访问器依赖外部变量时，强制重算 |
transitions | — | 属性过渡配置 |
coordinateSystem | LNGLAT | 坐标参考，点云常用 CARTESIAN |
modelMatrix | 单位矩阵 | 整体变换矩阵 |
parameters | — | WebGL 参数覆盖，深度测试等 |
extensions | [] | 着色器扩展，如虚线、路径样式 |
更新判定
传入新的 data 引用会重建属性缓冲；
引用不变则不重算。访问器里用到外部变量（例如滑块值）时，
把它写进 updateTriggers，否则画面不会变。
new deck.ScatterplotLayer({
id: 'points',
data: points,
getRadius: function (d) { return d.v * scale; },
updateTriggers: { getRadius: scale }
});拾取字段
回调里拿到的是 info：
object 原始数据、index 下标、
layer 图层实例、coordinate 经纬度、
x / y 屏幕坐标。
id 必须稳定。同一图层每次更新换一个 id，deck.gl 会当成新图层， 重新创建 GPU 资源，帧率随更新频率一起往下掉。
经纬志（2026）。《Layer》。https://www.jingweizhi.com/deckgl/api/layer.html（访问日期 2026-11-03）。