选项数据

选项数据设置是针对选择类型的字段，可选择项进行自定义设置；当选项来自接口、外部上下文或统一维护的数据集时，通常还会分别配合远程请求、导入外部数据与预定义全局数据一起使用。

设置入口

自定义表单中选项数据支持静态数据、远程数据、全局数据源设置，在「组件配置 >> 属性配置」处设置：

功能说明

静态数据

功能简述

• 直接在组件配置中硬编码选项列表，格式通常为键值对数组（如 [{label: '选项1', value: 1}, ...]）。
• 支持多层级嵌套（如树形选择器）。
• 无需异步请求，渲染速度快。

应用场景

• 固定选项表单：
  • 性别选择（男/女/其他）
  • 国家/地区选择（选项较少且不常变更）
  • 订单状态（待支付/已支付/已取消）
• 简单配置场景：
  • 后台管理系统的权限角色选择
  • 问卷中的单选/多选题（选项已知且有限）

远程数据

功能简述

• 通过API请求动态获取选项数据，支持分页、搜索、防抖等高级功能。
• 可配置请求参数、缓存策略、错误处理。
• 适合选项数据量大或频繁变更的场景；如果你需要进一步了解请求头、变量替换、beforeFetch 或结果解析方式，可以继续查看远程请求。

应用场景

• 动态数据表单：
  • 用户选择器（从数据库加载用户列表）
  • 产品分类选择（电商系统中分类可能随时增减）
  • 实时数据关联（如根据已选省份加载城市列表）
• 大数据量场景：
  • 联系人选择（支持搜索过滤）
  • 企业组织架构选择（树形结构+懒加载）
• 第三方数据集成：
  • 天气城市选择（调用天气API）
  • 股票代码选择（对接金融数据接口）

全局数据源

功能简述

• 从系统预定义的全局数据集合中获取选项（如通过Context、Redux或全局配置文件）。
• 支持跨组件共享数据，避免重复请求。
• 适合多表单复用相同选项的场景；这类共享数据通常会先在全局侧维护，再回到组件属性中选择使用，相关导入方式可参考预定义全局数据。

应用场景

• 企业级应用：
  • 统一管理全局选项（如国家列表、货币类型）
  • 多表单共享部门/职位数据
• 主题配置：
  • 全局颜色选择器（所有表单使用相同色板）
  • 字体大小配置选项
• 多语言系统：
  • 语言选择器（所有表单使用统一的语言列表）
  • 地区格式配置（日期/数字格式）

功能示例

以性别为例，需要男、女、保密三个选项时可以直接在选项数据中维护

需要增加更多选项的时候，直接添加添加按钮

级联类型的选项支持添加多级选项数据，按钮依次是新增同级选项、新增子级选项、删除本选项

如果这些选项不是手工维护，而是由页面在运行时动态注入，也可以先通过导入外部数据挂载数据，再在属性配置中读取对应变量或数据源，适合做跨页面共享的动态选项。