2015-08-01 14:08:04 +08:00
|
|
|
|
# Upload
|
|
|
|
|
|
|
|
|
|
|
|
- category: Components
|
|
|
|
|
|
- chinese: 文件上传
|
2015-08-22 20:16:24 +08:00
|
|
|
|
- type: 表单
|
2015-08-01 14:08:04 +08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2015-08-05 21:18:34 +08:00
|
|
|
|
文件选择上传和拖拽上传控件。
|
2015-08-01 14:08:04 +08:00
|
|
|
|
|
2015-08-05 21:18:34 +08:00
|
|
|
|
## 何时使用
|
2015-08-01 14:08:04 +08:00
|
|
|
|
|
2015-08-09 18:00:20 +08:00
|
|
|
|
上传是将信息从个人计算机（本地计算机）传递到中央计算机（远程计算机）系统上,让网络上的人都能看到.将制作好的网页、文字、图片、视频通过网页或者上传工具软件发布到互联网上的服务器系统上去,以便让其他人浏览、欣赏。这一过程称为上传。
|
2015-08-08 23:37:35 +08:00
|
|
|
|
|
2015-08-05 21:18:34 +08:00
|
|
|
|
- 当需要上传一个或一些文件时。
|
|
|
|
|
|
- 当需要展现上传的进度时。
|
|
|
|
|
|
- 当需要使用拖拽交互时。
|
2015-08-09 18:05:50 +08:00
|
|
|
|
|
2015-08-08 23:37:35 +08:00
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 |
|
|
|
|
|
|
|----------- |--------------------------------------------------------- | ---------- |-------|
|
|
|
|
|
|
| name | 可选参数, 上传的文件 | String | file |
|
|
|
|
|
|
| action | 必选参数, 上传的地址 | String | 无 |
|
|
|
|
|
|
| data | 可选参数, 上传所需参数 | Object | 无 |
|
2015-08-18 17:30:36 +08:00
|
|
|
|
| multiple | 可选参数, 是否支持多选文件，支持ie10+ | Boolean | false |
|
|
|
|
|
|
| accept | 可选参数, 接受上传的文件类型, 详见input accept Attribute | String | 无 |
|
2015-08-08 23:37:35 +08:00
|
|
|
|
| onError | 可选参数, error callback |Function | 无 |
|
|
|
|
|
|
| onSuccess | 可选参数, success callback | Function | 无 |
|
|
|
|
|
|
| onProgress | 可选参数, progress callback, 现代浏览器有效 | Function | 无 |
|
2015-08-18 17:30:36 +08:00
|
|
|
|
|
|
|
|
|
|
### onError
|
|
|
|
|
|
|
|
|
|
|
|
错误回调，有三个参数返回：
|
|
|
|
|
|
|
|
|
|
|
|
1. `err` 请求返回错误信息
|
|
|
|
|
|
2. `responce` 请求响应，包括错误状态码等信息
|
|
|
|
|
|
3. `file` 错误的文件对象
|
|
|
|
|
|
|
|
|
|
|
|
### onSuccess
|
|
|
|
|
|
|
|
|
|
|
|
成功回调，返回两个参数
|
|
|
|
|
|
|
|
|
|
|
|
1. `result` 上传图片返回结果
|
|
|
|
|
|
2. `file` 文件对象
|
