mirror/ant-design
1
0
Fork 0
mirror of https://github.com/ant-design/ant-design.git synced 2024-11-29 05:29:37 +08:00
Code Issues Actions 20 Packages Projects Releases Wiki Activity
63b33d4020
ant-design/components/message/index.en-US.md
MuYu fb0b4f0fc9 docs: show version Number features were added (#17373) 
* docs: add api first appearance

* docs: fix auto-complete doc

* docs: replace Version Added with Version

* docs: date picker common method

* docs: date picker common method

* docs: tree

* docs: remove meaningless 3.0.0
2019-07-11 14:14:33 +08:00

2.4 KiB
Raw Blame History

category type noinstant title
Components Feedback true Message

Display global messages as feedback in response to user operations.

When To Use

  • To provide feedback such as success, warning, error etc.
  • A message is displayed at top and center and will be dismissed automatically, as a non-interrupting light-weighted prompt.

API

This components provides some static methods, with usage and arguments as following:

  • message.success(content, [duration], onClose)
  • message.error(content, [duration], onClose)
  • message.info(content, [duration], onClose)
  • message.warning(content, [duration], onClose)
  • message.warn(content, [duration], onClose) // alias of warning
  • message.loading(content, [duration], onClose)
Argument Description Type Default Version
content content of the message string|ReactNode -
duration time(seconds) before auto-dismiss, don't dismiss if set to 0 number 1.5
onClose Specify a function that will be called when the message is closed Function -

afterClose can be called in thenable interface:

  • message[level](content, [duration]).then(afterClose)
  • message[level](content, [duration], onClose).then(afterClose)

where level refers one static methods of message. The result of then method will be a Promise.

  • message.open(config)

The properties of config are as follows:

Property Description Type Default Version
content content of the message ReactNode -
duration time(seconds) before auto-dismiss, don't dismiss if set to 0 number 3
onClose Specify a function that will be called when the message is closed function -
icon Customized Icon ReactNode - 3.9.0

Global static methods

Methods for global configuration and destruction are also provided:

  • message.config(options)
  • message.destroy()

message.config

message.config({
  top: 100,
  duration: 2,
  maxCount: 3,
});
Argument Description Type Default Version
duration time before auto-dismiss, in seconds number 1.5 3.9.0
getContainer Return the mount node for Message () => HTMLElement () => document.body 3.9.0
maxCount max message show, drop oldest if exceed limit number - 3.9.0
top distance from top number 24 3.9.0