Skip to content

文件上传

该组件是低代码平台中用于上传单个或多个文件的表单项,基于 <UploadFile> 封装,支持拖拽上传、文件类型/大小/数量限制、自定义上传目录及提示信息,并深度集成表单容器(<el-form>)的数据绑定与校验体系。

基础属性

属性类型说明
文件类型 fileTypestring[]允许上传的文件扩展名列表(如 ['.pdf', '.docx']
大小限制(MB) fileSizenumber单个文件最大允许大小(单位:MB,如 10 表示 10MB)
数量限制 limitnumber最多可上传的文件数量(默认为 1
是否拖拽上传 dragboolean启用拖拽区域样式(用户可将文件拖入上传区)
是否显示提示 isShowTipboolean是否在上传区域下方显示格式/大小等提示文字(默认开启)
上传目录 directorystring指定文件在服务器端的存储路径前缀(如 'user/avatar/'),用于后端路由或分类存储
表单项基础配置包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine

高级属性

属性类型说明
表单项高级配置包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine

事件

事件触发时机说明
change上传文件列表发生变化时返回当前所有已上传文件的元数据数组(结构由上传服务决定)