Alert
Alert component for feedback.
When To Use#
When you need to show alert messages to users.
When you need a persistent static container which is closable by user actions.
Examples
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => <Alert message="Success Text" type="success" />;
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const onClose = (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => {
console.log(e, 'I was closed.');
};
const App: React.FC = () => (
<>
<Alert
message="Warning Text Warning Text Warning TextW arning Text Warning Text Warning TextWarning Text"
type="warning"
closable
onClose={onClose}
/>
<Alert
message="Error Text"
description="Error Description Error Description Error Description Error Description Error Description Error Description"
type="error"
closable
onClose={onClose}
/>
</>
);
export default App;
Detailed description and advice about successful copywriting.
Additional description and information about copywriting.
This is a warning notice about copywriting.
This is an error message about copywriting.
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Alert message="Success Tips" type="success" showIcon />
<Alert message="Informational Notes" type="info" showIcon />
<Alert message="Warning" type="warning" showIcon closable />
<Alert message="Error" type="error" showIcon />
<Alert
message="Success Tips"
description="Detailed description and advice about successful copywriting."
type="success"
showIcon
/>
<Alert
message="Informational Notes"
description="Additional description and information about copywriting."
type="info"
showIcon
/>
<Alert
message="Warning"
description="This is a warning notice about copywriting."
type="warning"
showIcon
closable
/>
<Alert
message="Error"
description="This is an error message about copywriting."
type="error"
showIcon
/>
</>
);
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Alert message="Warning text" banner />
<br />
<Alert
message="Very long warning text warning text text text text text text text"
banner
closable
/>
<br />
<Alert showIcon={false} message="Warning text without icon" banner />
<br />
<Alert type="error" message="Error text" banner />
</>
);
export default App;
placeholder text here
TypeScript
JavaScript
import { Alert } from 'antd';
import React, { useState } from 'react';
const App: React.FC = () => {
const [visible, setVisible] = useState(true);
const handleClose = () => {
setVisible(false);
};
return (
<div>
{visible ? (
<Alert message="Alert Message Text" type="success" closable afterClose={handleClose} />
) : null}
<p>placeholder text here</p>
</div>
);
};
export default App;
Error Description Error Description Error Description Error Description
TypeScript
JavaScript
import { Alert, Button, Space } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Alert
message="Success Tips"
type="success"
showIcon
action={
<Button size="small" type="text">
UNDO
</Button>
}
closable
/>
<Alert
message="Error Text"
showIcon
description="Error Description Error Description Error Description Error Description"
type="error"
action={
<Button size="small" danger>
Detail
</Button>
}
/>
<Alert
message="Warning Text"
type="warning"
action={
<Space>
<Button size="small" type="ghost">
Done
</Button>
</Space>
}
closable
/>
<Alert
message="Info Text"
description="Info Description Info Description Info Description Info Description"
type="info"
action={
<Space direction="vertical">
<Button size="small" type="primary">
Accept
</Button>
<Button size="small" danger type="ghost">
Decline
</Button>
</Space>
}
closable
/>
</>
);
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Alert message="Success Text" type="success" />
<Alert message="Info Text" type="info" />
<Alert message="Warning Text" type="warning" />
<Alert message="Error Text" type="error" />
</>
);
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => (
<>
<Alert
message="Success Text"
description="Success Description Success Description Success Description"
type="success"
/>
<Alert
message="Info Text"
description="Info Description Info Description Info Description Info Description"
type="info"
/>
<Alert
message="Warning Text"
description="Warning Description Warning Description Warning Description Warning Description"
type="warning"
/>
<Alert
message="Error Text"
description="Error Description Error Description Error Description Error Description"
type="error"
/>
</>
);
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
const App: React.FC = () => <Alert message="Info Text" type="info" closeText="Close Now" />;
export default App;
TypeScript
JavaScript
import { Alert } from 'antd';
import React from 'react';
import Marquee from 'react-fast-marquee';
const App: React.FC = () => (
<Alert
banner
message={
<Marquee pauseOnHover gradient={false}>
I can be a React component, multiple React components, or just some text.
</Marquee>
}
/>
);
export default App;
TypeScript
JavaScript
import { Alert, Button } from 'antd';
import React, { useState } from 'react';
const { ErrorBoundary } = Alert;
const ThrowError: React.FC = () => {
const [error, setError] = useState<Error>();
const onClick = () => {
setError(new Error('An Uncaught Error'));
};
if (error) {
throw error;
}
return (
<Button danger onClick={onClick}>
Click me to throw a error
</Button>
);
};
const App: React.FC = () => (
<ErrorBoundary>
<ThrowError />
</ErrorBoundary>
);
export default App;
API#
Property | Description | Type | Default | Version |
---|---|---|---|---|
action | The action of Alert | ReactNode | - | 4.9.0 |
afterClose | Called when close animation is finished | () => void | - | |
banner | Whether to show as banner | boolean | false | |
closable | Whether Alert can be closed | boolean | - | |
closeText | Close text to show | ReactNode | - | |
closeIcon | Custom close icon | ReactNode | <CloseOutlined /> | 4.18.0 |
description | Additional content of Alert | ReactNode | - | |
icon | Custom icon, effective when showIcon is true | ReactNode | - | |
message | Content of Alert | ReactNode | - | |
showIcon | Whether to show icon | boolean | false, in banner mode default is true | |
type | Type of Alert styles, options: success , info , warning , error | string | info , in banner mode default is warning | |
onClose | Callback when Alert is closed | (e: MouseEvent) => void | - |
Alert.ErrorBoundary#
Property | Description | Type | Default | Version |
---|---|---|---|---|
description | Custom error description to show | ReactNode | {{ error stack }} | |
message | Custom error message to show | ReactNode | {{ error }} |