js-snackbar

What is a SnackBar?

According to Material Design a Snackbar or Toast provides "brief messages about app processes at the bottom of the screen."

Generally, they should not have an icon associated with it and should be only one line on most devices.

While this version of a SnackBar follows the Material Design semantics closely, it strays in several major ways.

You can send multiple snackbars to a user at a time, as opposed to a single snackbar at a time.
The SnackBar appears in the bottom right corner, as opposed to the bottom left or bottom center.

Basic Usage

Simply call SnackBar() to create the a notification message with default options, or pass an options object that includes some of the properties below in Options.

Options

To customize a SnackBar, pass the function a JS object with any of the following properties. All properties are optional.

Property	typeof	Default Value	Notes
message	`string`	`"Operation performed successfully."`
dismissible	`boolean`	`true`
timeout	`number` or `boolean`	`5000`	Integer represents milliseconds. To specify no timeout, set the value to `false` or any number less than or equal to `0`
status	`string`		Possible statuses include "success", "green", "warning", "alert", "orange", "danger", "error", "red." All other values will default to the blue "info" status
actions	`array`	`[]`	See Actions
fixed	`boolean`	`false`	`true` indicates a `positioning:fixed;` be added to the container
position	`string`	`"br"`	Possible values are `"br"`, `"tr"`, `"tc"`, `"tm"`, `"bc"`, `"bm"`, `"tl"`, or `"bl"`
container	`DOMNode` or `string`	`document.body`	If a string is provided, the string is passed to `querySelector` to find the container
width	`string`		Any valid CSS value for `width`
speed	`string` or `number`		Any valid CSS value for `transition-duration` or a duration in milliseconds
icon	`string`	`""`	See Icons

Actions

Actions should be an array of objects matching the format

{
    text: string;
    function?: () => void;
    dismiss?: boolean;
}

At minimum, an action must have a text field, which will simply create a dismiss button with custom text. Alternatively, you can specify a function property which defines a custom function to be run once the action is clicked. This can be anything and is passed no parameters. If function is defined but you still want the action click to dismiss the SnackBar, then you can specify dismiss = true to indicate that, once your method has run to completion, then the action will be automatically dismissed.

Icons

In order for icons to be visible, status must be set to a non-empty value. The icon property accepts any string value. This values will be truncated to a single character (e.g., "alert" will be shortened to "a") and displayed within the status indicator. There are several pre-defined values you can use with friendly names to make them easier to remember:

! -> "exclamation", "warn", or "danger"
? -> "info", "question", or "question-mark"
+ -> "plus" or "add"