Skip to content

全局变量

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

全局变量列表

在哪里找

全局配置全局变量

在属性「从变量读取」、变量绑定逻辑条件计算公式、远程请求参数中,也可打开变量列表插入。

和变量绑定、外部数据的关系

概念做什么
全局变量(本文)在设计器里定义可复用变量(常含计算)
变量绑定把变量接到组件属性
外部 / 内置数据环境或运行时写入的 $form$cookie、自定义名等,可在绑定与请求里引用

怎么用(分步)

  1. 创建变量,填写名称与说明(见名知意)。
  2. 配置取值:固定值,或计算(根据表单字段、Cookie、其它变量算出结果)。
  3. 在默认值、条件、公式、数据源请求、变量绑定中引用。
  4. 预览时改关联字段,确认引用处更新。

计算变量在算什么(概念)

计算时可读取:

  • 当前表单字段(如 $form.price
  • Cookie / 本地存储
  • 其它全局变量、全局数据
  • 环境注入的外部变量

关联数据变化时,计算变量会刷新,依赖它的绑定与展示一并更新。

在哪里引用

场景用法
字段默认值申请人默认读 currentUserName
组件属性变量绑定占位、禁用等
逻辑条件条件里选变量参与判断
公式用函数读取变量(以公式面板为准)
远程请求参数/头里写 {{变量}}{{$var.xxx}}

对象取值:{{变量名.属性}}(以界面说明为准)。

全局变量列表

业务示例

入门:默认申请人

变量 currentUserName 读取当前用户姓名 → 「申请人」默认值绑定该变量。打开即带出,仍允许修改。

入门:功能开关

变量 showVipBlock(计算或外部写入)→ 隐藏条件控制会员专区是否显示。

常用:明细合计多处共用

表格公式算出合计 → 暴露/写入全局变量 totalAmount → 顶部统计栏与提交确认文案都引用,避免两处各算各的。

常用:token 供数据源使用

计算变量从 Cookie 取 token(无则占位)→ 全局数据源请求头引用。改登录态后选项请求带新 token。

常用:表单事件写入变量

表单事件「渲染完毕」时设置变量,供后续字段默认值或动作读取。

常用:与权限配合

权限判断优先身份与权限;若环境把「是否可编辑」写成变量,再用变量绑定 props.disabled

管理建议

建议说明
命名稳定被多处引用后慎改名
写描述方便同事知道用途
避免循环A 依赖 B、B 又依赖 A
敏感信息勿把密钥明文写进固定值说明

注意点

  • 引用前确认变量在预览/运行时已有值。
  • 计算失败时检查依赖字段是否改名或删除。
  • 仅单处使用的临时值,不必强行建成全局变量。

相关阅读

相关技术文档