更新时间:2024-12-04 GMT+08:00
分享

新增项目变量

项目变量是整个项目中所有页面都可以的变量,当项目中页面较多且各页面会使用同一个变量时,通过创建项目变量,可以提高开发效率,提升易用性。

创建项目变量

  1. 参考登录AstroCanvas界面中操作,登录AstroCanvas界面。
  2. 在AstroCanvas界面的项目列表中,单击已创建的项目,进入项目。
  3. 在主菜单中,选择“项目设置”,进入项目设置页面。
  4. 在页面右上角,选择“编辑项目”,获取项目编辑权限。
  5. 在左侧菜单栏中,选择“项目变量”,单击“添加变量”
  6. 设置新建变量的参数,单击“确定”

    图1 添加变量
    • 变量:输入新建项目变量的名称,只能由字母、数字组成,且必须以字母开头。
    • 默认值:新建项目变量的默认取值。
    • 变量说明:新建项目变量的说明信息,可以是变量的含义或用途等。
    • 作用域:选择项目变量作用的页面,可以是项目中的所有页面也可以是某一个或多个页面。

  7. 设置完成后,单击“保存”,完成变量的创建。

使用项目变量

  1. 参考创建页面中操作,创建所需的页面。
  2. 在页面上方的工具栏中,单击,可查看到创建项目变量中创建的项目变量。

    如果在页面中新建一个页面级全局变量,且变量的名称和项目变量一致(如ProjectVariable),则只有页面全局变量会生效。
    图2 查看项目变量

  3. 在数据或交互动作中,使用项目变量。

    1. 选中页面中的组件,单击组件上方的,在组件数据中使用项目变量。
      图3 在组件数据中使用项目变量
    2. 选中页面中组件,单击组件上方的,在交互动作中使用项目变量。
      图4 在交互动作中使用项目变量

  4. 更新项目变量。

    • 方式一:通过交互动作,更新变量。
      图5 在交互动作中更新变量
    • 方式二:通过自定义动作,更新项目变量。
      图6 通过自定义动作更新变量

      其中,key为项目变量的名称,value为项目变量的值。

相关文档