首页 / deck.gl / API 文档

View

先看结论

视图基类。描述画布上的一个观察区域，以及它使用的视角状态。

最后验证 2026-11-03 · deck.gl 9.0 · 更新 2026-10-27 · 引用本文

new deck.View(props)

参数

参数	默认	说明
`id`	`null`	视图标识，多视图时唯一
`x` / `y`	`0`	相对画布左上角的位置
`width` / `height`	`'100%'`	尺寸，可传数字或百分比
`controller`	`false`	该视图的交互控制器
`viewState`	继承全局	受控模式下该视图的视角
`padding`	`null`	视口内边距，影响适配范围

viewState 的键

单视图时 viewState 是扁平对象。多视图时按键分组：{ left: {...}, right: {...} }。键名与视图 id 对应。

new deck.Deck({
  views: [
    new deck.MapView({ id: 'left', x: 0, width: '50%' }),
    new deck.MapView({ id: 'right', x: '50%', width: '50%' })
  ],
  initialViewState: {
    left: { longitude: 116.4, latitude: 39.9, zoom: 9 },
    right: { longitude: 121.5, latitude: 31.2, zoom: 9 }
  }
});

与图层的配合

视图不隔离图层。所有图层会画在每个视口里，需要只在一个视口显示时，按视图 id 在 layers 里筛选，或把图层拆到不同的 Deck 实例。

视图尺寸变化后要重新计算。容器用 CSS 改了大小时，调用 deckgl.setProps({width, height})，否则视口裁剪会错位。

引用本文

经纬志（2026）。《View》。https://www.jingweizhi.com/deckgl/api/view.html（访问日期 2026-11-03）。