# Upload

- category: Components
- chinese: 文件上传

---

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

## 何时使用

上传是将信息从个人计算机（本地计算机）传递到中央计算机（远程计算机）系统上,让网络上的人都能看到.将制作好的网页、文字、图片、视频通过网页或者上传工具软件发布到互联网上的服务器系统上去,以便让其他人浏览、欣赏。这一过程称为上传。

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

## 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     | 无    |

### onError

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

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

### onSuccess

成功回调，返回两个参数

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