ant-design/components/upload/index.md

Upload

• category: Components
• chinese: 文件上传
• type: 表单

---

文件选择上传和拖拽上传控件。

何时使用

上传是将信息（网页、文字、图片、视频等）通过网页或者上传工具发布到远程服务器上的过程。

• 当需要上传一个或一些文件时。
• 当需要展现上传的进度时。
• 当需要使用拖拽交互时。

API

参数	说明	类型	默认值
name	可选参数, 上传的文件	String	file
action	必选参数, 上传的地址	String	无
data	可选参数, 上传所需参数	Object	无
multiple	可选参数, 是否支持多选文件，支持ie10+	Boolean	false
accept	可选参数, 接受上传的文件类型, 详见input accept Attribute	String	无
onError	可选参数, error callback	Function	无
onSuccess	可选参数, success callback	Function	无
onProgress	可选参数, progress callback, 现代浏览器有效	Function	无
urlResolver	通过解析请求返回数据，获得文件上传的远程地址	Function	function() { return JSON.parse(ret).url }
limit	文件上传数量的限制	Number	Number.MAX_VALUE

onError

错误回调，有三个参数返回：

1. err 请求返回错误信息
2. responce 请求响应，包括错误状态码等信息
3. file 错误的文件对象

onSuccess

成功回调，返回两个参数

1. result 上传图片返回结果
2. file 文件对象