FcDesigner Pro

Appearance

全局变量 ​

全局变量把可复用的共享值做成「变量资产」。在组件数据绑定、条件、公式、远程请求参数等处引用，避免多处手写同一取值。

全局配置中的设置变量入口

在哪里找 ​

左侧功能栏 → 全局配置 → 设置变量。

在组件配置的 数据绑定 弹窗里，也可展开变量列表中的 全局变量（$var） 选用。

和数据绑定、外部数据的关系 ​

概念管什么
全局变量（本文）在设计器里定义可复用变量（固定值或计算）
数据绑定把变量接到组件属性 / 组件的值上
外部 / 内置数据运行时写入的 $cookie、$localStorage、表单字段等，可在绑定与请求里引用

典型模式：多处要读同一共享值 → 沉淀全局变量，各处通过 数据绑定 引用（不要把 {{$var.xxx}} 直接填进默认值）。

text
全局变量「当前申请人」
    ↑ 数据绑定
申请人 字段「设置组件的值」

怎么用（分步） ​

1. 创建全局变量 ​

  1. 打开全局配置 → 设置变量（入口见图文开头）。
  2. 点 创建变量，填写键名与标签（如 var_current_user / 「当前申请人」）。

创建变量与当前申请人

  1. 配置取值：固定值，或按登录态 / 其它字段计算后保存。

配置变量取值

计算脚本旁的变量列表 ​

若取值用计算（脚本 function handle(get, api)），编辑区右侧有窄栏，点展开图标打开 变量列表（说明：包含表单所有相关变量，点击可快速插入代码或复制名称）。

展开变量列表

展开后可浏览当前表单字段、$cookie / 存储、全局变量（$var）、国际化 $t 等；点名称插入到脚本光标处，也可用 复制。

变量列表面板

TIP

同一套变量列表面板也出现在组件事件自定义、全局事件脚本编辑里。右侧 帮我写 可用自然语言改脚本，见AI 表单助理。

用 get 读表单字段并按值返回 ​

计算脚本的第一个参数是 get：用来读取当前表单字段、Cookie、其它变量等。第二个参数是 api（表单接口，进阶再用）。

常见写法：get('路径', 默认值)。路径可从右侧变量列表点选后改成 get 调用；表单字段示意见编辑器占位，形如 $form.字段ID（具体 ID 以你表单为准，列表里能看到）。

按字段值不同返回不同结果，例如根据「请假类型」返回不同选项数组：

js
function handle(get, api) {
  const leaveType = get('$form.Fdoc00316', '');
  if (leaveType === 'sick') {
    return [
      { label: '门诊病假', value: 'outpatient' },
      { label: '住院病假', value: 'inpatient' }
    ];
  }
  if (leaveType === 'annual') {
    return [
      { label: '带薪年假', value: 'annual' },
      { label: '加班调休', value: 'comp' }
    ];
  }
  return [
    { label: '年假', value: 'annual' },
    { label: '事假', value: 'personal' },
    { label: '病假', value: 'sick' }
  ];
}

（示例中的字段 ID、选项文案请换成你环境里的真实值；也可返回字符串、数字等，不必一定是选项数组。）

get 读取请假类型并按值分支

计算脚本：get 与不同分支 return

TIP

依赖的字段值变化时，引用该全局变量的数据绑定会跟着更新。更多 get / 模板变量语法见技术文档变量。

2. 在数据绑定中引用 ​

  1. 选中要赋值的字段（如「申请人」输入框）→ 打开组件配置，点 数据绑定。

打开数据绑定

  1. 将「设置组件的值」设为「变量」。

设置组件的值绑定变量

  1. 右侧变量列表展开 全局变量（$var） → 点选「当前申请人」。

选用当前申请人

  1. 确定后预览：字段应带出变量当前值，仍可按业务允许修改。

预览核对申请人

场景示例 ​

入门：申请人读当前用户 ​

背景：请假表打开时，「申请人」希望默认带出当前登录人姓名。

步骤：

  1. 按上文创建全局变量「当前申请人」（固定值或计算均可）。
  2. 选中「申请人」→ 数据绑定 → 「设置组件的值」选「变量」→ $var 下点选「当前申请人」（操作同「在数据绑定中引用」）。
  3. 预览打开表单，确认申请人已带出。

画布上申请人读全局变量

预期：改变量取值后，经数据绑定引用的字段一起更新。

常用：选项随其它字段变化 ​

背景：希望「明细选项」随「请假类型 / 所属部门」等字段变化，而不是写死一份静态选项。

步骤：

  1. 创建全局变量（如「请假子类型选项」），取值选计算。
  2. 在脚本里用 get('$form.字段ID', '') 读取依赖字段，再按 if 返回不同的 { label, value } 数组（见上文「用 get 读表单字段并按值返回」与图 variable-28、variable-29）。
  3. 把目标选择器的 选项数据 通过数据绑定接到该 $var（或按界面把选项绑到全局变量）。
  4. 预览时切换依赖字段，确认选项列表跟着变。

预期：依赖字段一变，选项同步更新；逻辑集中在全局变量一处维护。

常用：同一变量服务字段与请求参数 ​

背景：除了给申请人赋值，远程选项请求也可能需要当前用户相关信息。

步骤：

  1. 在全局变量中维护「当前申请人」与（如需要）token 类变量。
  2. 字段通过 数据绑定 读申请人变量；远程请求的参数 / 请求头用 {{变量}} 引用（见选项数据 · 远程数据、全局数据源）。
  3. 预览时抽查字段展示与选项加载。

预期：登录态或变量变更后，数据绑定字段与远程请求一起更新。

常用：功能开关控制显隐 ​

背景：会员专区是否显示，希望由一处开关控制多张表。

步骤：

  1. 创建全局变量「显示会员专区」（计算或外部写入）。
  2. 在会员相关区域的隐藏条件里引用该变量。
  3. 预览切换变量取值，确认显隐一致。

预期：开关一处改，各表会员区同步。

维护建议 ​

建议说明
命名见名知意var_current_user、当前申请人；键名用下划线，不要用点号
写清标签数据绑定列表里方便配置人员选用
改前回归影响所有引用处，改完预览主路径
避免循环依赖A 依赖 B、B 又依赖 A；get 读字段时也不要和该字段的绑定互相套死
不要过度全局化只用一次的临时值写在字段本身即可

注意点 ​

  • 给字段赋值请走 数据绑定，不要在默认值里手写 {{$var.xxx}}。
  • 引用前确认变量在预览 / 运行时已有值；get 的路径、字段 ID 以变量列表为准。
  • 计算失败时检查依赖字段是否改名或删除。
  • 敏感信息勿把密钥明文写进固定值说明。

相关阅读 ​

相关技术文档 ​