全局变量
全局变量用于定义表单可读取的共享数据或计算结果。变量变化时,引用它的配置可同步更新,适合默认值、显隐条件、文案拼接、请求参数等场景。

在哪里找
全局配置 → 全局变量。
在属性「从变量读取」、变量绑定、逻辑条件、计算公式、远程请求参数中,也可打开变量列表插入。
和变量绑定、外部数据的关系
| 概念 | 做什么 |
|---|---|
| 全局变量(本文) | 在设计器里定义可复用变量(常含计算) |
| 变量绑定 | 把变量接到组件属性上 |
| 外部 / 内置数据 | 环境或运行时写入的 $form、$cookie、自定义名等,可在绑定与请求里引用 |
怎么用(分步)
计算变量在算什么(概念)
计算时可读取:
- 当前表单字段(如
$form.price) - Cookie / 本地存储
- 其它全局变量、全局数据
- 环境注入的外部变量
关联数据变化时,计算变量会刷新,依赖它的绑定与展示一并更新。
在哪里引用
| 场景 | 用法 |
|---|---|
| 字段默认值 | 申请人默认读 currentUserName |
| 组件属性 | 变量绑定占位、禁用等 |
| 逻辑条件 | 条件里选变量参与判断 |
| 公式 | 用函数读取变量(以公式面板为准) |
| 远程请求 | 参数/头里写 {{变量}} 或 {{$var.xxx}} |
对象取值:{{变量名.属性}}(以界面说明为准)。

业务示例
入门:默认申请人
变量 currentUserName 读取当前用户姓名 → 「申请人」默认值绑定该变量。打开即带出,仍允许修改。
入门:功能开关
变量 showVipBlock(计算或外部写入)→ 隐藏条件控制会员专区是否显示。
常用:明细合计多处共用
表格公式算出合计 → 暴露/写入全局变量 totalAmount → 顶部统计栏与提交确认文案都引用,避免两处各算各的。
常用:token 供数据源使用
计算变量从 Cookie 取 token(无则占位)→ 全局数据源请求头引用。改登录态后选项请求带新 token。
常用:表单事件写入变量
表单事件「渲染完毕」时设置变量,供后续字段默认值或动作读取。
常用:与权限配合
权限判断优先身份与权限;若环境把「是否可编辑」写成变量,再用变量绑定 props.disabled。
管理建议
| 建议 | 说明 |
|---|---|
| 命名稳定 | 被多处引用后慎改名 |
| 写描述 | 方便同事知道用途 |
| 避免循环 | A 依赖 B、B 又依赖 A |
| 敏感信息 | 勿把密钥明文写进固定值说明 |
注意点
- 引用前确认变量在预览/运行时已有值。
- 计算失败时检查依赖字段是否改名或删除。
- 仅单处使用的临时值,不必强行建成全局变量。


