mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-27 18:50:59 +08:00
75 lines
3.5 KiB
Markdown
75 lines
3.5 KiB
Markdown
|
---
|
|||
|
|
category: Components
|
|||
|
|
type: Form Controls
|
|||
|
|
english: Upload
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
Upload file by selecting or dragging
|
|||
|
|
|
|||
|
|
## When to use
|
|||
|
|
|
|||
|
|
Uploading is the process of publishing information (web pages, text, pictures, video, etc.) to a remote server via a web page or upload tool.
|
|||
|
|
|
|||
|
|
- When you need to upload one or more files.
|
|||
|
|
- When you need to show the process of uploading.
|
|||
|
|
- When you need to upload files by dragging and dropping.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## API
|
|||
|
|
|
|||
|
|
| Property | Description | Type | Default|
|
|||
|
|
|------------|----------------------------------------------------| ----------- |--------|
|
|||
|
|
| name | Optional. The name of uploading file | String | file |
|
|||
|
|
| defaultFileList | Optional. Default list of files that have been uploaded. | Array[Object] | - |
|
|||
|
|
| fileList | Optional. List of files that have been uploaded. | Array[Object] | - |
|
|||
|
|
| action | Required. Uploading URL | String | - |
|
|||
|
|
| data | Optional. Uploading params or function which can return uploading params. | Object or function(file) | - |
|
|||
|
|
| headers | Optional. Set request headers, valid above IE10. | Object | - |
|
|||
|
|
| showUploadList | Optional. Whether to show uploadList. | Boolean | true |
|
|||
|
|
| multiple | Optional. Whether to support selected multiple file. `IE10+` supported. You can select multiple files with CTRL holding down while multiple is set to be true | Boolean | false |
|
|||
|
|
| accept | Optional. File types that can be accepted. See [input accept Attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-accept) | String | - |
|
|||
|
|
| beforeUpload | Optional. Hook function which takes an argument: the uploaded file, will be executed before uploading. Uploading will be stopped with `false` or a rejected Promise returned. **Warning：this function is not supported by old IE**。 | Function | - |
|
|||
|
|
| onChange | Optional. A callback function, can be executed when uploading state is changing. See [onChange](#onChange) | Function | - |
|
|||
|
|
| listType | Optional. Built-in stylesheets, support for two types: `text` or `picture` | String | 'text'|
|
|||
|
|
| onPreview | A callback function, will be executed when file link is clicked. | Function(file) | - |
|
|||
|
|
| onRemove | A callback function, will be executed when removing file button is clicked | Function(file) | - |
|
|||
|
|
| supportServerRender | Need to be turned on while the server side is rendering.| Boolean | false |
|
|||
|
|
|
|||
|
|
### onChange
|
|||
|
|
|
|||
|
|
> The function will be called when uploading is in progress, completed or failed
|
|||
|
|
|
|||
|
|
When uploading state change, it returns:
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
{
|
|||
|
|
file: { /* ... */ },
|
|||
|
|
fileList: [ /* ... */ ],
|
|||
|
|
event: { /* ... */ },
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
1. `file` File object for the current operation.
|
|||
|
|
|
|||
|
|
```js
|
|||
|
|
{
|
|||
|
|
uid: 'uid', // unique identifier，negative is recommend，to prevent interference with internal generated id
|
|||
|
|
name: 'xx.png' // file name
|
|||
|
|
status: 'done', // options：uploading, done, error, removed
|
|||
|
|
response: '{"status": "success"}', // response from server
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
If multiple files are uploaded, this parameter will be Array Object `[file, ...]`
|
|||
|
|
|
|||
|
|
2. `fileList` current list of files
|
|||
|
|
3. `event` response from server, including uploading progress, supported by advanced browsers.
|
|||
|
|
|
|||
|
|
## show download links
|
|||
|
|
|
|||
|
|
please set property `url` of property `fileList` to control content of link
|
|||
|
|
|
|||
|
|
## IE note
|
|||
|
|
|
|||
|
|
- [https://github.com/react-component/upload#ie89-note](https://github.com/react-component/upload#ie89-note)
|