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

CZML 引用属性

除了位置,颜色、朝向这些属性也能引用。改一处,所有引用它的对象一起变。

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

属性引用写法

字段写成 reference 加「对象 id#属性路径」即可,路径可以是 label.outlineColor 这样的嵌套字段。

什么时候用

多个对象共用一套样式时最有用,例如一排灯共用同一个颜色属性,调节时只改被引用的那一个对象。

可以直接改的地方

位置改什么效果
position.referenceid#position位置复用
label.outlineColor.referenceid#label.outlineColor颜色复用
被引用对象的字段改值所有引用一起变

引用是实时的:引用实时解析,被引用对象被删除后引用方会拿到空值,画面上表现为消失。