页面变量

变量类型概览

页面变量大致分为两类：

• 外部变量：值从 URL 参数或嵌入场景的传参中获取，例如报表跳转到 UX 页面时携带的 req_id。

• 变量元素/模型变量：从变量元素或 DeepModel 中取数，作为页面的统一上下文（如当前年度、当前实体）。

外部变量

增加外部变量的主要目的为：

1. 定义页面参数，便于外部读取，进行 UI 配置，无需记忆两边的 key。

2. 降低配置 urlQuery 的学习成本。

新增【外部】类型，参数仅可配置变量编码，变量类型默认为 string。

此类变量的值默认通过外部传入，包括 url 参数和嵌入后的传参，其效果等同于在表达式中配置 $urlQuery.req_id，最终都可以统一通过 $var.变量编码 的方式在页面内使用。

👉点击跳转：外部变量应用详情见-如何配置清单表的跳转

变量元素

UX 中支持添加变量元素，并且将变量元素中的成员作为 UX 中的变量进行使用。

变量元素成员支持配置编码、名称、数据格式、是否多选、是否启用维度表达式等信息，用于描述变量的含义和取值方式。

当页面加载时，页面会根据已关联的变量元素和 DeepModel 变量自动拉取当前值，填充到变量的数据中，此后即可在表达式中通过 $var.变量编码 进行使用。

运行时结构与表达式访问

在运行时，页面变量会以统一的对象挂载到表达式上下文中（在表达式编辑器中通常以“变量”类型出现），常见能力包括：

• 统一保存所有变量成员的最终值，是 $var.变量编码 实际读取的数据来源。

• 记录变量元素和外部变量的字段信息，便于在编辑器中选择。

• 管理变量取数的加载状态与异常信息，便于在页面上做相应处理。

表达式中的常见用法示例：

• 使用变量元素中的成员：$var.Year、$var.Entity

• 使用外部变量并参与计算：$var.req_id === $components.req_id_input.value

通过外部变量与变量元素的组合，可以在页面中统一管理“来自 URL / 嵌入场景”以及“来自模型/变量元素”的上下文信息。