You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ant-design-vue/components/notification/index.en-US.md

2.8 KiB

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

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
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
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