文件上传
该组件是低代码平台中用于上传单个或多个文件的表单项,基于 <UploadFile> 封装,支持拖拽上传、文件类型/大小/数量限制、自定义上传目录及提示信息,并深度集成表单容器(<el-form>)的数据绑定与校验体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
文件类型 fileType | string[] | 允许上传的文件扩展名列表(如 ['.pdf', '.docx']) |
大小限制(MB) fileSize | number | 单个文件最大允许大小(单位:MB,如 10 表示 10MB) |
数量限制 limit | number | 最多可上传的文件数量(默认为 1) |
是否拖拽上传 drag | boolean | 启用拖拽区域样式(用户可将文件拖入上传区) |
是否显示提示 isShowTip | boolean | 是否在上传区域下方显示格式/大小等提示文字(默认开启) |
上传目录 directory | string | 指定文件在服务器端的存储路径前缀(如 'user/avatar/'),用于后端路由或分类存储 |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 上传文件列表发生变化时 | 返回当前所有已上传文件的元数据数组(结构由上传服务决定) |
