Upload 控件介绍

Upload 上传一个或多个文件，并把服务端返回的文件元数据交给 Form。它会加入所在 Form 的字段状态、校验和提交范围。

1. 适用场景

常见用途：

• 附件和证明材料
• 图片或文档上传
• 需要格式、数量和大小限制的文件输入

2. 添加与配置

1. 把 Upload 添加到 Form Section 的 Fields 区域。
2. 设置稳定且唯一的 Field Key / Name，并让它与后端 DTO 属性一致。
3. 配置本页列出的组件属性，再按需要设置 Required、Help Text、Full row 和条件表达式。
4. 在设计预览中检查初始值和布局，并使用 Form 的 Validate / Submit 验证完整数据链路。

3. 主要属性

属性	作用
Multiple	启用或关闭该行为。
Form Upload / Upload URL	定义可选数据的来源和映射方式。
Component Style	控制字段在设计预览和运行态中的显示方式。
Upload Format Filter	限制允许的数量、长度或取值范围。
Upload Count / Size Limit	限制允许的数量、长度或取值范围。
Enable Image Cropping	启用或关闭该行为。

Field Key、Required、Help Text、Full row、Visible When 等通用属性由 Form 字段契约提供；本表列出的是使用 Upload 时最需要关注的配置。

4. 表单值与后端契约

该字段提交的值： 文件元数据数组；具体字段由上传接口响应与映射决定，不是浏览器二进制对象。

[
  {"id": "file-1024", "name": "evidence.pdf", "url": "/files/file-1024"}
]

示例仅说明数据形状；接口仍应按业务 DTO 校验类型、范围和权限。

5. 校验、条件与交互

所有字段都可使用 Form 的 Required、Visible When、Disabled When、Required When、Dependencies 和 Clear When Hidden。条件表达式只控制交互，不代替后端权限与校验。

组件能力： 支持 setValue；上传成功脚本和上传状态用于处理服务端响应。

6. 使用建议

配置建议： 先固定请求与响应 JSON 契约，再配置字段；对数组项、文件元数据和服务端错误路径做端到端测试。

返回 Form 总览，了解布局、校验、提交、草稿和后端协议。