Notification 通知提醒框

全局展示通知提醒信息。

何时使用

在系统四个角显示通知提醒信息。经常用于以下情况：

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

代码演示

基本

最简单的用法，4.5 秒后自动关闭。

import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification } from 'choerodon-ui';
​
const openNotification = () => {
  notification.open({
    message: 'Notification Title',
    description: 'This is the content of the notification. This is the content of the notification. This is the content of the notification.',
  });
};
​
ReactDOM.render(
  <Button type="primary" onClick={openNotification}>Open the notification box</Button>,
  document.getElementById('container'));
​

自动关闭的延时

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

import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification } from 'choerodon-ui';
​
const openNotification = () => {
  const args = {
    message: 'Notification Title',
    description: 'I will never close automatically. I will be close automatically. I will never close automatically.',
    duration: 0,
  };
  notification.open(args);
};
​
ReactDOM.render(
  <Button type="primary" onClick={openNotification}>Open the notification box</Button>,
  document.getElementById('container'));
​

带有图标的通知提醒框

通知提醒框左侧有图标。

import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification } from 'choerodon-ui';
​
const openNotificationWithIcon = (type) => {
  notification[type]({
    message: 'Notification Title',
    description: 'This is the content of the notification. This is the content of the notification. This is the content of the notification.',
  });
};
​
ReactDOM.render(
  <div>
    <Button onClick={() => openNotificationWithIcon('success')}>Success</Button>
    <Button onClick={() => openNotificationWithIcon('info')}>Info</Button>
    <Button onClick={() => openNotificationWithIcon('warning')}>Warning</Button>
    <Button onClick={() => openNotificationWithIcon('error')}>Error</Button>
  </div>,
  document.getElementById('container'));
​

自定义按钮

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

​
import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification } from 'choerodon-ui';
​
const close = () => {
  console.log('Notification was closed. Either the close button was clicked or duration time elapsed.');
};
​
const openNotification = () => {
  const key = `open${Date.now()}`;
  const btn = (
    <Button type="primary" size="small" onClick={() => notification.close(key)}>
      Confirm
    </Button>
  );
  notification.open({
    message: 'Notification Title',
    description: 'A function will be be called after the notification is closed (automatically after the "duration" time of manually).',
    btn,
    key,
    onClose: close,
  });
};
​
ReactDOM.render(
  <Button type="primary" onClick={openNotification}>
    Open the notification box
  </Button>,

自定义图标

图标可以被自定义。

import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification, Icon } from 'choerodon-ui';
​
const openNotification = () => {
  notification.open({
    message: 'Notification Title',
    description: 'This is the content of the notification. This is the content of the notification. This is the content of the notification.',
    icon: <Icon type="smile-circle" style={{ color: '#108ee9' }} />,
  });
};
​
ReactDOM.render(
  <Button type="primary" onClick={openNotification}>Open the notification box</Button>,
  document.getElementById('container'));
​

位置

可以设置通知从右上角、右下角、左下角、左上角弹出。

​
import React from 'react';
import ReactDOM from 'react-dom';
import { Button, Select, notification } from 'choerodon-ui';
​
const { Option } = Select;
const options = ['topLeft', 'topRight', 'bottomLeft', 'bottomRight'];
const openNotification = () => {
  notification.open({
    message: 'Notification Title',
    description: 'This is the content of the notification. This is the content of the notification. This is the content of the notification.',
  });
};
​
ReactDOM.render(
  <div>
    <Select
      defaultValue="topRight"
      style={{ width: 120, marginRight: 10 }}
      onChange={(val) => {
        notification.config({
          placement: val,
        });
      }}
    >
      {options.map(val => <Option key={val} value={val}>{val}</Option>)}
    </Select>
    <Button
      type="primary"

自定义样式

使用 style 和 className 来定义样式。

import React from 'react';
import ReactDOM from 'react-dom';
import { Button, notification } from 'choerodon-ui';
​
const openNotification = () => {
  notification.open({
    message: 'Notification Title',
    description: 'This is the content of the notification. This is the content of the notification. This is the content of the notification.',
    style: {
      width: 600,
      marginLeft: 335 - 600,
    },
  });
};
​
ReactDOM.render(
  <Button type="primary" onClick={openNotification}>Open the notification box</Button>,
  document.getElementById('container'));
​

API

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

config 参数如下：

还提供了一个全局配置方法，在调用前提前配置，全局一次生效。

• notification.config(options)

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