Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content
This repository has been archived by the owner on Apr 30, 2020. It is now read-only.
/ md-snackbars Public archive

Snackbars and Toasts based on Google's Material Design

License

Notifications You must be signed in to change notification settings

255kb/md-snackbars

Repository files navigation

/!\ This package is not maintained anymore /!\

Snackbars and Toasts based on Google's Material Design

MD Snackbars is a lightweight package allowing to show notification to the user based on Google's Material Design. View a demo

See Google's Material Design specifications for more information about Snackbars.

Dependencies

  • jQuery

Installation

You can install MD-Snackbars with Bower:

bower install md-snackbars

or with Meteor:

meteor add 255kb:md-snackbars

How to use

1. Init MD-Snackbars

MDSnackbars.init();

Not needed in order to use MDSnackbars.show() and MDSnackbars.hide() but needed in order to be able to hide the snackbar on click and show a snackbar using data attributes.

For Meteor, be sure to use MDSnackbars.init(); in your templates onRendered callbacks.

2. Show/hide a snackbar programmatically

MDSnackbars.show(options);
MDSnackbars.hide();

See below for more information about options.

3. Show a snackbar using data attributes

In order to show a snackbar using data attributes you can use data-toggle="md-snackbar" and the following options:

<button data-toggle = "md-snackbar"
        data-text = "message"
        data-toast = "false"
        data-align = "left"
        data-full-width = "false"
        data-bottom = 100
        data-timeout = "3000"
        data-html = "false"
        data-click-close = "true"
        data-animation = "slideup">Show</button>
        
MDSnackbars.init();

4. Default options

Default options are the following:

var options = {
    text: 'message',        // change snackbar's text/html
    toast: false,           // change snackbar's style (true = rounded corners)
    align: 'left',          // align 'left' or 'right'
    fullWidth: false,       // snackbar takes all screen width (overrides align and toast style, also remove default 2px rounded corners)
    bottom: 100,            // position from bottom (default to 20px or 0 if fullWidth is true)
    timeout: 3000,          // delay before the snackbar disappears (if 0, the snackbar is permanently showed until MDSnackbars.hide() is called or the snackbar clicked)
    html: false ,           // allows HTML insertion
    clickToClose: true,     // enable/disable the click to close behavior
    animation: 'fade'       // change the animation type ('fade' or 'slideup', default to 'fade')
};

MDSnackbars.show(options);

5. Behavior

Snackbars are not stackable according to Material Design's specifications. When a snackbar is showed, all subsequent snackbars will be queued and showed as soon as the previous one has disappeared. When you queue a snackbar without a timeout it will be showed permanently until dismissed with a click or MDSnackbars.hide(), the processing of the queue will resume as soon as this snackbar is hidden.

Snackbars can be dismissed with a click (be sure to init the plugin with MDSnackbars.init()). This behavior can be disabled by using data-click-close="false" attribute or the clickToClose option.

Changelog

v1.3.1:

  • bug fix

v1.3.0:

  • snackbars are now automatically queued
  • switched to CSS transitions
  • added slide up transition

v1.2.5:

  • Added option "bottom" to set bottom positioning (default is still 20px, or 0 for full width snackbars)
  • updates to the docs

v1.2.4:

  • Correct bug that prevented Meteor package to work

v1.2.3:

  • Added the Meteor package
  • docs update

About

Snackbars and Toasts based on Google's Material Design

Resources

License

Stars

Watchers

Forks

Packages

No packages published