文件上传
文件选择上传。
基础使用
禁用上传组件
图片上传
提示信息
操作栏控制
API
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| accept | 接受上传的文件类型 参考：https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept | string[] | ||
| beforeUpload | 上传文件之前的钩子，参数为上传的文件，若返回 false 则停止上传 | (file: UploadFile, fileList: UploadFile[] ) => boolean | Promise<any> | ||
| buttonText | 按钮文字描述 | string | 文件上传 | |
| customRequest | 通过覆盖默认的上传行为，可以自定义自己的上传实现 | (params: UploadRequestOption) => void | ||
| data | 上传所需参数或返回上传参数的方法 | object | ( file: UploadFile ) => object | ||
| defaultFiles | 已经上传的文件列表（受控） | UploadFile[] | ||
| disabled | 是否禁用 | Boolean | Ref<Boolean> | ComputedRef<Boolean> | ||
| downloadUrl | 请求后台的api | string | ApiType | ||
| extraParams | 额外需要传给后台的参数 | Recordable | ||
| fileName | 文件名用哪个参数 | string | 'file' | |
| headers | 设置上传的请求头部，IE10 以上有效 | Object | ||
| helpText | 帮助信息提示 | string | ||
| listType | 上传列表类型 | 'text' | 'picture-card' | 'text' | |
| maxCount | 限制上传数量。当为 1 时，始终用最新上传的文件代替当前文件 | Number | ||
| maxSize | 文件最大多少mb | number | Infinity | |
| multiple | 是否支持多选文件，ie10+ 支持。开启后按住 ctrl 可选择多个文件 | boolean | false | |
| onChange | 附件内容改变 | (ids: string[] | number[], files: UploadFile[]) => void | |
| preIcon | 按钮文字图标 | string | ||
| showDelete | 是否显示删除按钮 | boolean | true | |
| showDownload | 是否显示下载按钮 | boolean | true | |
| showView | 是否显示预览按钮 | boolean | true | |
| uploadUrl | 请求后台的api | string | ApiType |
UploadFile
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| fileId | 文件id | string | ||
| name | 文件名 | string | ||
| percent | 上传进度 | number | ||
| status | 上传状态，不同状态展示颜色也会有所不同 | 'error' | 'success' | 'done' | 'uploading' | 'removed' | ||
| thumbUrl | 缩略图地址 | string | ||
| uid | 唯一标识符，不设置时会自动生成 | string | ||
| url | 下载地址 | string |