经纬志
首页 / Cesium / 使用示例

数据源层级顺序

用 CustomDataSource 分组管理实体,再用 raise 调整组间压盖顺序。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

顺序决定压盖

viewer.dataSources 是一个有序集合,后面的数据源绘制在前面之上。raise、lower、raiseToTop 改变顺序,比重新 add 更省事。

和 zIndex 的区别

数据源顺序是组级别的,作用于整组实体;entity.zIndex 是单个贴地对象的顺序。两者冲突时,组顺序先决,组内再看 zIndex。

接口作用说明
new CustomDataSource(name)创建空数据源可随时 add 实体
dataSources.raise(ds)上移一层只影响组顺序
dataSources.indexOf(ds)查当前位置判断是否需要调整

CzmlDataSource、GeoJsonDataSource 同样参与这个顺序,加载顺序不同会让叠加结果看起来不一样。