New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More
Socket
Sign inDemoInstall
Socket

@harshitpant/notistack

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@harshitpant/notistack

Highly customisable notification snackbars (Material-UI Snackbar) that can be stacked on top of each other

0.2.2
latest
Source
npm
Version published
Weekly downloads
8
700%
Maintainers
1
Weekly downloads
 
Created
Source

notistack

Notistack is an extention to Material-ui Snackbar that manages snackbars so they can be displayed and stacked on top of one another. It's highly customizable and you can customize it the same way you do for Mui-Snackbars.

Play with online demo here
Stacking behaviourDismiss oldest when reached maxSnack (3 here)

Getting Started

Use your prefered package manager:

npm install notistack
yarn add notistack 

Usage

1: Wrap your app inside a SnackbarProvider component: (see docs for a full list of available props)

import { SnackbarProvider } from 'notistack';

<SnackbarProvider maxSnack={3}>
    <App />
</SnackbarProvider>

2: Export any component that needs to send notification using withSnackbar. By doing this, you'll have access to the method onPresentSnackbar in your props which can be used to send snackbars.

import { withSnackbar } from 'notistack';

class MyComponent extends Component {
  
  handleNetworkRequest = () => {
     const { onPresentSnackbar } = this.props; 
     fetchSomeData()
        .then(() => onPresentSnackbar('success', 'Successfully fetched the data.'))
        .catch(() => onPresentSnackbar('error', 'Failed fetching data.'));
  };

  render(){
     //...
  };
  
};

export default withSnackbar(MyCompnent);

Demo

You can see the online demo and experiment all the possible configurations here.
Or see the code for a minimal working example: codesandbox
Edit notistack-demo

Docs

SnackbarProvider: Besides maxSnack and iconVariant, any other prop gets passed down to a Snackbar component. See Material-ui Snackbar docs for more info.

// Maximum number of snackbars that can be stacked on top of eachother.
maxSnack            type: number          required: true        default=3

// The little icon that is displayed in a snackbar
iconVariant         type: any             required: false       default=Material design icons

// An example of prop passed to Mui-Snackbar
transitionDuration={{ exit: 380, enter: 400 }}

withSnackbar: When you export your component using withSnackbar you'll have access to onPresentSnackbar in your props that basically adds a snackbar to the queue to be displayed to the user. It takes two arguments variant and message.

// type of the snackbar
variant         type:string             oneOf(['error', 'success', 'warning', 'info'])

// text of the snackbar
message         type:string             

Future

  • Allow snackbar type customization
  • Some snackbars should get dismissed after timeout and some other should only get dissmissed when user clicks on dismiss/close button.

Contribution

Open an issue and your problem will be solved.

Notes

Material Design guidelines suggests that only one snackbar should be displayed at a time. But I liked to stack them. 😂 So I made notistack.

Author - Contact

Hossein Dehnokhalaji

Hossein Dehnokhalaji Linkedin profile Hossein Dehnokhalaji Linkedin profile Hossein Dehnokhalaji Linkedin profile Hossein Dehnokhalaji email address

Keywords

react

FAQs

Package last updated on 09 Oct 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts