Notification 通知提醒框

全局展示通知提醒信息。

何时使用#

在系统右上角显示通知提醒信息。经常用于以下情况:

  • 较为复杂的通知内容。
  • 带有交互的通知,给出用户下一步的行动点。
  • 系统主动推送。

API#

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

config 参数如下:

参数 说明 类型 默认值
message 通知提醒标题,必选 React.Element or String
description 通知提醒内容,必选 React.Element or String
btn 自定义关闭按钮 React.Element
key 当前通知唯一标志 String
onClose 点击默认关闭按钮时触发的回调函数 Function
duration 默认 4.5 秒后自动关闭,配置为 null 则不自动关闭 Number 4.5

还提供了一个全局配置方法,需要在调用前提前配置,一次有效。

  • notification.config(options)
notification.config({
  top: 100
});
参数 说明 类型 默认值
top 消息距离顶部的位置 Number 24px

代码演示

import { Button, notification } from 'antd';

const openNotification = function () {
  notification.open({
    message: '这是标题',
    description: '这是提示框的文案这是提示框的文案这是提示框的文案这是提示框的文案这是提示框的文案这是提示框的文案这是提示框的文案'
  });
};

ReactDOM.render(
  <Button type="primary" onClick={openNotification}>打开通知提醒框</Button>
, mountNode);

最简单的用法,五秒后自动关闭。

import { Button, notification } from 'antd';

const openNotificationWithIcon = function (type) {
  return function () {
    notification[type]({
      message: '这是标题',
      description: '这是提示框的文案这是提示框示框的文案这是提示是提示框的文案这是提示框的文案'
    });
  };
};

ReactDOM.render(
  <div>
    <Button onClick={openNotificationWithIcon('success')}>成功</Button>
    <Button onClick={openNotificationWithIcon('info')}>消息</Button>
    <Button onClick={openNotificationWithIcon('warn')}>警告</Button>
    <Button onClick={openNotificationWithIcon('error')}>错误</Button>
  </div>
, mountNode);

通知提醒框左侧有图标。

import { Button, notification } from 'antd';

const openNotification = function () {
  const args = {
    message: '这是标题',
    description: '我不会自动关闭,我不会自动关闭,我不会自动关闭,我不会自动关闭,我不会自动关闭,我不会自动关闭,我不会自动关闭',
    duration: 0
  };
  notification.open(args);
};

ReactDOM.render(
  <Button type="primary" onClick={openNotification}>打开通知提醒框</Button>
, mountNode);

自定义通知框自动关闭的延时,默认4.5s,取消自动关闭只要将该值设为 0 即可。

import { Button, notification } from 'antd';

const close = function () {
  console.log('我被默认的关闭按钮关闭了!');
};

const openNotification = function () {
  const key = `open${Date.now()}`;
  const btnClick = function () {
    // 隐藏提醒框
    notification.close(key);
  };
  const btn = (
    <Button type="primary" size="small" onClick={btnClick}>
      自定义关闭按钮并触发回调函数
    </Button>
  );
  notification.open({
    message: '这是标题',
    description: '这是提示框的文案这是提示框示框的文案这是提示是提示框的文案这是提示框的文案',
    btn,
    key,
    onClose: close
  });
};

ReactDOM.render(
  <div>
    <Button type="primary" onClick={openNotification}>打开通知提醒框</Button>
  </div>,
mountNode);

自定义关闭按钮的样式和文字。