# Upload

- category: Components
- chinese: 文件上传

---

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

## 何时使用

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

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

## API

| 参数        | 说明                                                      | 类型        | 默认值 |
|----------- |---------------------------------------------------------  | ---------- |-------|
| name       | 可选参数, 上传的文件                                         | String      | file    |
| action     | 必选参数, 上传的地址                                         | String      | 无    |
| data       | 可选参数, 上传所需参数                                       | Object      | 无    |
| accept     | 可选参数, 接受上传的文件类型, 详见input accept Attribute      | String      | 无    |
| onError    | 可选参数, error callback                                   |Function     | 无    |
| onSuccess  | 可选参数, success callback                                 | Function     | 无    |
| onProgress | 可选参数, progress callback, 现代浏览器有效                  | Function     | 无    |