2016-07-04 10:44:55 +08:00
|
|
|
---
|
|
|
|
category: Components
|
2016-11-09 14:43:32 +08:00
|
|
|
type: Feedback
|
2016-07-04 10:44:55 +08:00
|
|
|
noinstant: true
|
2016-09-21 11:28:38 +08:00
|
|
|
title: Message
|
2016-07-04 10:44:55 +08:00
|
|
|
---
|
|
|
|
|
2017-09-10 21:47:02 +08:00
|
|
|
Display global messages as feedback in response to user operations.
|
2016-07-04 10:44:55 +08:00
|
|
|
|
|
|
|
## When To Use
|
|
|
|
|
2017-09-10 21:47:02 +08:00
|
|
|
- To provide feedback such as success, warning, error etc.
|
2016-07-04 10:44:55 +08:00
|
|
|
- A message is displayed at top and center and will be dismissed automatically, as a non-interrupting light-weighted prompt.
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
2017-03-19 14:16:39 +08:00
|
|
|
This components provides some static methods, with usage and arguments as following:
|
|
|
|
|
2017-02-27 21:50:08 +08:00
|
|
|
- `message.success(content, duration, onClose)`
|
|
|
|
- `message.error(content, duration, onClose)`
|
|
|
|
- `message.info(content, duration, onClose)`
|
|
|
|
- `message.warning(content, duration, onClose)`
|
2017-03-19 14:21:16 +08:00
|
|
|
- `message.warn(content, duration, onClose)` // alias of warning
|
2017-02-27 21:50:08 +08:00
|
|
|
- `message.loading(content, duration, onClose)`
|
2016-07-04 10:44:55 +08:00
|
|
|
|
2017-10-25 10:25:44 +08:00
|
|
|
| Argument | Description | Type | Default |
|
|
|
|
| -------- | ----------- | ---- | ------- |
|
|
|
|
| content | content of the message | string\|ReactNode | - |
|
|
|
|
| duration | time before auto-dismiss, in seconds | number | 1.5 |
|
|
|
|
| onClose | Specify a function that will be called when the message is closed | Function | - |
|
2016-07-04 10:44:55 +08:00
|
|
|
|
|
|
|
Methods for global configuration and destruction are also provided:
|
|
|
|
|
|
|
|
- `message.config(options)`
|
|
|
|
- `message.destroy()`
|
|
|
|
|
2017-03-19 02:07:39 +08:00
|
|
|
### message.config
|
|
|
|
|
2016-07-04 10:44:55 +08:00
|
|
|
```js
|
|
|
|
message.config({
|
|
|
|
top: 100,
|
|
|
|
duration: 2,
|
|
|
|
});
|
|
|
|
```
|
|
|
|
|
2017-10-25 10:25:44 +08:00
|
|
|
| Argument | Description | Type | Default |
|
|
|
|
| -------- | ----------- | ---- | ------- |
|
|
|
|
| duration | time before auto-dismiss, in seconds | number | 1.5 |
|
2017-09-10 21:47:02 +08:00
|
|
|
| getContainer | Return the mount node for Message | () => HTMLElement | () => document.body |
|
2017-10-25 10:25:44 +08:00
|
|
|
| top | distance from top | number | 24px |
|