# 拖放式附件上传控件

将完整的 TSX 源码粘贴到易企办审批表单的自定义代码控件中。在表单配置里选择可写的附件变量，再用测试表单检查上传、提交和重新打开后的值。数据列表自定义表单也可按同样方式试配，需要独立验证写回和保存。

## 参数

| 配置 ID | 类型 | 用途 | 示例 |
| --- | --- | --- | --- |
| `attachmentTarget` | 变量 | 可写的附件变量。单文件模式写入一个附件对象，多文件模式写入数组。 | 选择表单中的「供应商报价」附件变量 |
| `multiple` | 变量 | `true` 启用多文件，`false` 使用单文件。 | `true` |
| `acceptedFileTypes` | 文本 | 逗号分隔的扩展名或 MIME 类型，例如 `.pdf,.docx,image/*`。留空时控件允许所有类型，租户限制仍适用。 | `.pdf,.png,.jpg` |
| `maxFileSizeMB` | 文本 | 单文件浏览器端上限，默认 20 MB。 | `20` |
| `maxFileCount` | 文本 | 多文件模式的数量上限，默认 10。 | `10` |
| `title` | 文本 | 上传区域主提示。 | `上传供应商报价` |
| `helperText` | 文本 | 辅助说明，留空显示配置摘要。 | `请上传供应商报价单或补充图片` |
| `displaySize` | 文本 | `Large`、`Medium` 或 `Small`。默认 `Large`。 | `Large` |
| `hideUploadedFiles` | 变量 | `true` 隐藏控件中的文件列表，附件变量仍可写回。 | `false` |

## 配置示例

采购报价表可把控件绑定到「供应商报价」，使用单文件模式，文件类型为 `.pdf,.png,.jpg`，上限 20 MB。对于支持材料，可绑定单独的附件变量，打开多文件模式并将数量上限设置为 10。

支持 PDF、常见图像和文本类文件的浏览器预览。Office 文件和压缩包可通过下载查看。只读表单可以预览和下载有访问权限的附件。多文件模式可在浏览器内将已显示的附件打包下载。移除操作更新表单中的附件引用。

## 验收

- 拖放和文件选择器都能上传，类型、大小及数量校验符合实际规则。
- 上传后读取附件变量，再提交、打开记录并核对文件。
- 只读角色能查看允许访问的文件，上传区和移除按钮隐藏。
- 检查单文件下载、多文件打包、移除和窄屏布局。
- 使用测试资料核对租户的 SDK 文件权限及附件存储限制。