ant-design/components/notification/index.en-US.md

category	type	noinstant	title
Components	Feedback	true	Notification

Display a notification message globally.

When To Use

To display a notification message at any of the four corners of the viewport. Typically it can be used in the following cases:

• A notification with complex content.
• A notification providing a feedback based on the user interaction. Or it may show some details about upcoming steps the user may have to follow.
• A notification that is pushed by the application.

API

• notification.success(config)
• notification.error(config)
• notification.info(config)
• notification.warning(config)
• notification.warn(config)
• notification.close(key: String)
• notification.destroy()

The properties of config are as follows:

Property	Description	Type	Default
message	The title of notification box (required)	string|ReactNode	-
description	The content of notification box (required)	string|ReactNode	-
className	Customized CSS class	string	-
style	Customized inline style	React.CSSProperties	-
btn	Customized close button	ReactNode	-
icon	Customized icon	ReactNode	-
key	The unique identifier of the Notification	string	-
onClose	Specify a function that will be called when the close button is clicked	Function	-
duration	Time in seconds before Notification is closed. When set to 0 or null, it will never be closed automatically	number	4.5
placement	Position of Notification, can be one of topLeft topRight bottomLeft bottomRight	string	topRight

notification also provides a global config() method that can be used for specifying the default options. Once this method is used, all the notification boxes will take into account these globally defined options when displaying.

• notification.config(options)

notification.config({
  placement: 'bottomRight',
  bottom: 50,
  duration: 3,
});

Property	Description	Type	Default
placement	Position of Notification, can be one of topLeft topRight bottomLeft bottomRight	string	topRight
top	Distance from the top of the viewport, when placement is topRight or topLeft (unit: pixels).	number	24
bottom	Distance from the bottom of the viewport, when placement is bottomRight or bottomLeft (unit: pixels).	number	24
duration	Time in seconds before Notification is closed. When set to 0 or null, it will never be closed automatically	number	4.5
getContainer	Return the mount node for Notification	() => HTMLNode	() => document.body