概述
FieldForm 是负责字段创建、编辑和复制的核心表单组件。它的最大特点是字段类型的动态表单——根据用户选择的字段类型（Text、Number、Picklist 等），动态渲染该类型所需要配置的专属属性。
三种模式
| 模式 | 触发场景 | 行为差异 |
|---|---|---|
create | 点击"新建字段" | 空白表单，字段类型可修改，提供"保存并新建"按钮 |
edit | 点击字段的"编辑" | 加载现有字段数据，字段类型和 API 名称不可修改 |
copy | 点击字段的"复制" | 字段名和标签自动添加 _Copy / Copy 后缀 |
表单结构
Modal: 新建自定义字段 / 编辑字段
字段类型 * [选择下拉框]
API 名称 * [_______]
显示标签 * [_______]
描述 [_______]
帮助文本 [_______]
API 名称 * [_______]
显示标签 * [_______]
描述 [_______]
帮助文本 [_______]
字段类型专属设置 (例如 Picklist):
显示标签: [___] 实际值: [___] [×]
[+ 添加选项]
[取消] [保存并新建] [保存]
动态属性渲染
| 属性类型 | 渲染组件 | 示例场景 |
|---|---|---|
text | Input 文本框 | 长度、精度 |
number | Input number | 小数位数 |
boolean | Checkbox 复选框 | 是否必填、是否唯一 |
picklist_values | 动态选项列表 | 下拉列表的可选值 |
提交流程
- 表单验证：检查必填项
- 数据组装：合并基础属性 + 类型专属属性，生成
fullName = objectName.fieldName - API 调用：编辑模式
updateField/ 新建模式createField - 结果处理："保存"关闭 Modal + 触发
onSuccess；"保存并新建"重置表单 + 触发onSaveAndNewSuccess
技术要点
- 字段类型元数据：通过
getFieldTypes()API 获取 - Modal 尺寸：
medium - 编辑保护：编辑模式下 API 名称和字段类型锁定不可修改
- 组件库：
@salesforce/design-system-react的Modal,Input,Button,ScopedNotification
截图
保存并新建流程 — 待插入
../../images/product/one_platform/field-form-save-new.png
表单验证失败 — 待插入
../../images/product/one_platform/field-form-validation.png