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

批量显示与隐藏

把实体挂到父实体下,用父级的 show 一次性控制整组显隐。

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

父子实体

构造实体时传 parent,它就挂到父实体下。父实体的 show 为 false 时,子实体即使自己的 show 是 true 也不会绘制。

和单独开关的区别

逐个改子实体的 show 需要维护一份状态,容易漏改。用父级开关只改一个布尔值,语义清楚,也便于按图层或批次统一控制。

属性作用说明
parent建立父子关系构造时传入
entity.show控制自身及子级false 时整组隐藏
viewer.entities.show控制全部实体最外层总开关

父子关系不改变绘制顺序;父实体没有几何时也不会产生额外渲染开销。