更新时间：2025-07-24 GMT+08:00
项目级全局变量
华为云Astro大屏应用中的全局变量包括项目级全局变量和页面级全局变量两种。项目级全局变量是整个项目中所有页面都可以使用的变量，当项目中页面较多且各页面会使用同一个变量时，通过创建项目变量，可以提高开发效率，提升易用性。页面级全局变量仅针对当前页面生效。
如果在页面中新建一个页面级全局变量，且变量的名称和项目级全局变量一致（如ProjectVariable），则只有页面级全局变量会生效。
创建项目变量
- 参考登录华为云Astro大屏应用界面中操作，登录华为云Astro大屏应用界面。
- 在华为云Astro大屏应用界面的项目列表中，单击已创建的项目，进入项目。
- 在主菜单中，选择“项目设置”，进入项目设置页面。
- 在页面右上角，选择“编辑项目”，获取项目编辑权限。
- 在左侧菜单栏中，选择“项目变量”，单击“添加变量”。
- 设置新建变量的参数，单击“确定”。
图1 添加变量
- 变量：输入新建项目变量的名称，只能由字母、数字组成，且必须以字母开头。
- 默认值：新建项目变量的默认取值。
- 变量说明：新建项目变量的说明信息，可以是变量的含义或用途等。
- 作用域：选择项目变量作用的页面，可以是项目中的所有页面也可以是某一个或多个页面。
- 设置完成后，单击“保存”，完成变量的创建。
创建多个项目变量时，单击“开启调序”，可调整项目变量的顺序。调整变量顺序对页面中引用的变量无任何影响，只影响视觉效果。
使用项目变量
- 参考创建页面中操作，创建所需的页面。
- 在页面上方的工具栏中，单击
，可查看到创建项目变量中创建的项目变量。
如果在页面中新建一个页面级全局变量，且变量的名称和项目变量一致（如ProjectVariable），则只有页面全局变量会生效。图2 查看项目变量
- 在数据或交互动作中，使用项目变量。
- 选中页面中的组件，单击组件上方的
，在组件数据中使用项目变量。
图3 在组件数据中使用项目变量
- 选中页面中组件，单击组件上方的
，在交互动作中使用项目变量。
图4 在交互动作中使用项目变量
- 选中页面中的组件，单击组件上方的
- 更新项目变量。
- 方式一：通过交互动作，更新变量。
图5 在交互动作中更新变量
- 方式二：通过自定义动作，更新项目变量。
图6 通过自定义动作更新变量
其中，key为项目变量的名称，value为项目变量的值。
- 方式一：通过交互动作，更新变量。
父主题： 全局变量
