Snackbar component for Qwik
npm install qwik-snackbarLight weight snackbar module allows for easy usage and easy customization.
Not only for easy use, but accessibility is built in. Screen readers will read the snackbar once open, it also allows for the override of text that is read out.
---
npm i -D qwik-snackbar
Wrap QwikSnackbarProvider around root page (this allows for only a single snackbar that can be used anywhere)
```
export default component$(() => {
return (
<>
>
);
});
Once open, the screen reader will read out "Snackbar notification" (This can be changed with aria label prop passed to enqueueSnackbar$) and then the contents of the snackbar is read out.
Close button will read out "Close snackbar button, this snackbar will close automatically" or "Close snackbar button, this snackbar will not close automatically" depending on the autoClose prop.
Import context in any component
const { enqueueSnackbar$, dequeueSnackbar$ } = useSnackbarContext();
enqueueSnackbar$: opens snackbardequeueSnackbar$: closes snackbar
- QwikSnackbarProvider
- variants (allows for adding custom styles to variants to change the look of any variant)
- Object with optional properties
- default?: string;
- success?: string;
- error?: string;
- warning?: string;
- enqueueSnackbar$(messageDisplay: string | (() => JSXOutput) | JSXOutput, options?: Object)duration: number
- messageDisplay: string | (() => JSXOutput) | JSXOutput
- options
- variant?: "default" | "error" | "success" | "warning"
- time in ms
- default: 5000
- location?: "top-right" | "top-left" | "top-center" | "bottom-right" | "bottom-left" | "bottom-center"
- default: "default"
- animation?: "slide" | "fade"
- default: "top-right"
- animationLocation?: "top" | "right" | "bottom" | "left"
- default: "slide"
- autoClose?: boolean
- default: "right"
- ariaLabel?: string
- default: true
- closeButtonAriaLabel?: string`
- overrides what is initially read from screen reader when snackbar opens, after it reads this it will read the contents of the snackbar
- default: "Snackbar notification"
-
- overrides what is read for close button from screen reader
- default:
- autoClose enabled: "Close snackbar button, this snackbar will close automatically"
- autoClose disabled: "Close snackbar button, this snackbar will not close automatically"