Shows an alert in the position and for the duration specified. You will most likely want to pass your own custom alert component to use with the library, see below.
This library was influenced by schiehlls react-alert library. I liked what he had done but the project seems to no longer be supported, and I wanted something just a little different. Feel free to check out his library, maybe it will work better for your needs. Otherwise keep reading...
yarn add react-alerts-plus
or
npm install react-alerts-plus
import { AlertProvider } from 'react-alerts-plus';
class MyApp extends React.Component {
render() {
return (
<AlertProvider>
<App />
</AlertProvider>
);
}
}import { AlertWrapper } from 'react-alerts-plus';
...
...
render() {
const options = {
message: 'My alert message',
style: {
backgroundColor: 'cornflowerblue',
borderRadius: 0,
},
offset: '50px',
position: 'top right',
duration: 0,
}
}
return (
<div>
<button>
<AlertWrapper>
{({show, close}) => {
<button type="button" onClick={() => const alertId = show(options)}>Show Alert</button>
}}
<button type="button" onClick={() => close(alertId)}>
</AlertWrapper>
</div>
)
}The AlertWrapper returns a show and close function.
show(options, AlertComponent): The show function will display the alert using the options object passed. Returns the ID of the alert.
close(alertId): The close function will close the alert with the corresponding ID.
All three methods of using react-alerts-plus accept the same options, though some maybe ignored with different alerts.
Options are passed as an object, as the first argument to the show function. While z-index is not an option, you can pass a custom z-index in your styles and it will be applied. See below.
| Option | Type | Description |
|---|---|---|
| message | String / Number | message displayed in the alert |
| id | String / Number | id for the alert |
| style | Object | defining javascript styles |
| offset | String | defining the offset of the alert from position |
| duration | Number | time in milliseconds for the alert to be shown |
| position | String | placement of the alert |
| theme | String | default alert theme colors |
| showProgessBar | Bool | show auto close progress bar |
| progressBarColor | String | progress bar color |
| AlertComponent | PureComponent | pure components recommended |
message: 'Hi alert here!'
id: 'my-alert'
style: style: {
backgroundColor: 'cornflowerblue',
borderRadius: 0,
}
offset: '50px'
duration: 2000 (use 0 to never auto close the alert)
position: 'top left'
'top center'
'top right'
'bottom left'
'bottom center'
'bottom right'
theme: 'light' or 'dark' (light is default)
showProgressBar false
progressBarColor '#666', 'cornflowerblue', 'red'
AlertComponent: Default alert will be totally replaced by your custom alert.
Only offset, duration, id, showProgressBar, progressBarColor,
and position are used when passing a custom AlertComponent.
See below for specifics about using
your own custom alert component. **While custom alert
components can be functional stateless components, Components,
we recommend using PureComponents.**
const optionsExample = {
message: 'Hi alert here!',
id: 'my-alert',
style: {
backgroundColor: 'cornflowerblue',
borderRadius: 0,
zIndex: 1000,
},
offset: '50px',
duration: 2000,
position: 'top right',
theme: 'dark',
progressBarColor: 'cornflowerblue',
}
- Default alerts
- Base alert components
- Custom alerts
Default alerts are nothing fancy, just basic alerts that display using the options you pass to the show function. (See AlertWrapper example above).
To use the base alert components you still need to wrap your App in our AlertProvider and AlertWrapper, but you pass our CardAlert component as the second AlertComponent arguement to show. CardAlert will return any of the base alert components you wish to use.
- AlertContainer
- AlertHeader
- AlertBody
- AlertImage
- AlertProgressBar
As long as you pass props to this function you can make use of react-alerts-plus transitions (transitionStyle) and close function (see below).
A container to wrap your other alert components.
Special props:
- N/A.
- All your props are spread across this component for you to style your alert.
Alert header.
Special props:
- title: String. Alert title string
- All your props are spread across this component for you to style your alert.
The body of your alert.
Special props:
- message: String. Alert message string
- All your props are spread across this component for you to style your alert.
Displays an image for your Alert.
Special props:
- height: String. Height of image (ex: '200px')
- width: String. Width of image (ex: '200px')
- imageSrc: String. URL to image
- alt: String. alt attribute for image
- All your props are spread across this component for you to style your alert.
A propress bar showing how long the alert will remain open before the duration runs out. Will not be shown if:
- duration option is 0 (zero), never auto close
- showProgresBar option is false
Special props: These props can be pulled from the props passed into the CardAlert (the options you sent to show, see below) or passed manually.
- progressBarColor,
- alertTimeout,
- showProgressBar,
- state,
/** @jsx jsx */
import React from 'react';
import { Icon } from 'react-icons-kit';
import { ic_close as closeIcon } from 'react-icons-kit/md/ic_close';
import { jsx, css } from '@emotion/core';
import { AlertProvider, AlertWrapper, CardAlert } from 'react-alerts-plus';
...
...
render() {
const options = {
message: 'My alert message',
position: 'top left',
offset: '20px',
id: 'my-bottom-center-alert',
duration: 2000,
progressBarColor: 'linear-gradient(to right, yellow, orange, red)',
}
return (
<div>
<button>
<AlertWrapper>
{({show, close}) => (
<button
type="button"
onClick={() =>
show(options,
props => (
<CardAlert
render={({
AlertContainer,
AlertHeader,
AlertBody,
AlertImage,
AlertProgressBar,
}) => {
const {
transitionStyle,
close: cardAlertClose,
} = props;
return (
<AlertContainer
css={css`
display: grid;
grid-gap: 10px;
grid-template-rows: 40px 1fr 10px;
border: 1px solid lavenderblush;
justify-content: center;
padding: 20px;
width: 400px;
margin: 15px;
background-color: cadetblue;
box-shadow: 1px 1px 8px 1px #666;
`}
style={{ ...transitionStyle }}
>
<div
css={css`
display: grid;
grid-gap: 20px;
grid-template-columns: 1fr 20px;
`}
>
<AlertHeader
title="this is a title"
style={{ fontSize: '24pt' }}
/>
<Icon
size={20}
icon={closeIcon}
onClick={cardAlertClose}
/>
</div>
<div
css={css`
display: grid;
grid-gap: 15px;
grid-template-columns: 200px 1fr;
`}
>
<AlertImage
height={200}
width={200}
imageSrc={imageUri}
alt="My Alert Image"
/>
<AlertBody message="this is a message to body" />
</div>
<AlertProgressBar {...props} />
</AlertContainer>
);
}}
/>
),
)
}
>
CardAlert Bottom Center
</button>
)}
</AlertWrapper>
</div>
)
}While custom alert components can be a functional stateless component, Reac.Component, etc. we recommend using React.PureComponents.
Passing a custom alert component will cause some options to be ignored (see Option Examples above). The close function will be added as a prop for you to consume in your custom alert component. If you are going to use the close prop you will need to supply the custom ID with your options. You can also pass any other props you might need in your custom alert component. See the codesandbox demo link at the top of this README.
/* eslint-disable import/no-extraneous-dependencies */
/** @jsx jsx */
import React from 'react';
import PropTypes from 'prop-types';
import { jsx, css } from '@emotion/core';
import { Icon } from 'react-icons-kit';
import { ic_close as closeIcon } from 'react-icons-kit/md/ic_close';
class MyAlert extends React.PureComponent {
render() {
const {
close,
title,
message,
imageUri,
transitionStyle,
showProgressBar,
progressBarColor,
alertTimeout,
state,
} = this.props;
// console.log('rest = ', props);
const progressStyle = {
transition: `width ${alertTimeout}ms ease-in-out`,
width: '0px',
};
const progressTransitionStyles = {
entering: { width: '0px' },
entered: { width: '100%' },
};
return (
<div
key="someRandomKey"
css={css`
display: grid;
grid-gap: 10px;
grid-template-rows: 40px 1fr 10px;
border: 1px solid lavenderblush;
justify-content: center;
padding: 20px;
width: 400px;
margin: 15px;
background-color: cadetblue;
box-shadow: 1px 1px 8px 1px #666;
`}
style={{
...transitionStyle,
}}
>
<div
css={css`
display: grid;
grid-gap: 20px;
grid-template-columns: 1fr 20px;
`}
>
<header
css={css`
font-size: 18pt;
color: white;
`}
>
{title}
</header>
<div>
<Icon size={20} icon={closeIcon} onClick={close} />
</div>
</div>
<div
css={css`
display: grid;
grid-gap: 15px;
grid-template-columns: 200px 1fr;
`}
>
<img height="200" width="200" src={imageUri} alt="pic" />
<article
css={css`
color: #141414;
`}
>
{message}
</article>
</div>
{alertTimeout === 0
? null
: showProgressBar && (
<div
style={{
height: '10px',
backgroundColor: `${progressBarColor}`,
...progressStyle,
...progressTransitionStyles[state],
}}
/>
)}
</div>
);
}
}
MyAlert.propTypes = {
close: PropTypes.func,
title: PropTypes.string,
message: PropTypes.string,
imageUri: PropTypes.string,
};
MyAlert.defaultProps = {
close: () => {},
title: 'Default Title',
message: 'Default Message',
imageUri: '',
};
export default MyAlert;