menuMDUIDocs
color_lens
Das neue mdui 2 auf Basis von Material Design 3 und Web Components ist da. Zur mdui 2 Dokumentation wechseln.

Snackbar

Eine Snackbar zeigt eine kleine Popup-Box am unteren Rand des Fensters an, die nach einer Zeitüberschreitung oder wenn der Benutzer auf den Bildschirm klickt oder tippt, automatisch verschwindet.

Es kann jeweils nur eine Snackbar gleichzeitig auf dem Bildschirm angezeigt werden. Wenn eine weitere Snackbar geöffnet wird, während die aktuelle noch nicht geschlossen ist, wird die nächste Snackbar in eine Warteschlange eingereiht und erst geöffnet, nachdem die aktuelle geschlossen wurde.

Verwendung

Rufen Sie einfach die Methode mdui.snackbar(params) auf.

Verwendung

Die Snackbar wird direkt über JavaScript aufgerufen, es ist kein HTML-Layout erforderlich.

Es gibt zwei Möglichkeiten, eine Snackbar aufzurufen:

  • mdui.snackbar(message, params)
  • mdui.snackbar(params)

Beide Methoden geben eine Instanz der Snackbar zurück.

Unterstützte Parameter für Snackbar:

ParameternameTypStandardwertBeschreibung
messagestringDer Text der Snackbar. Bei Aufruf über mdui.snackbar(params) darf dieser Parameter nicht leer sein.
timeoutint4000Verzögerungszeit für das automatische Ausblenden der Snackbar in Millisekunden. Wenn auf 0 gesetzt, wird sie nicht automatisch geschlossen.
positionstringbottomDie Position der Snackbar.
  • bottom: unten
  • top: oben
  • left-top: oben links
  • left-bottom: unten links
  • right-top: oben rechts
  • right-bottom: unten rechts
buttonTextstringDer Text des Buttons.
buttonColorstring#90CAF9Die Textfarbe des Buttons, kann ein Farbname oder ein Farbwert sein, wie z.B. red, #ffffff, rgba(255, 255, 255, 0.3) usw.
closeOnButtonClickbooleantrueOb die Snackbar geschlossen wird, wenn auf den Button geklickt wird.
closeOnOutsideClickbooleantrueOb die Snackbar geschlossen wird, wenn auf einen Bereich außerhalb der Snackbar geklickt oder getippt wird.
onClickfunctionCallback-Funktion beim Klicken auf die Snackbar.
onButtonClickfunctionCallback-Funktion beim Klicken auf den Button der Snackbar.
onOpenfunctionCallback-Funktion beim Starten des Öffnens der Snackbar.
onOpenedfunctionCallback-Funktion nach dem Öffnen der Snackbar.
onClosefunctionCallback-Funktion beim Starten des Schließens der Snackbar.
onClosedfunctionCallback-Funktion nach dem Schließen der Snackbar.

Verfügbare Methoden der Snackbar-Instanz:

MethodennameBeschreibung
closeSchließt die Snackbar. Nach dem Schließen wird die Snackbar zerstört.

Beispiel

Einfache Snackbar

Beispiel
mdui.snackbar({
  message: 'Message sent'
});

Snackbar mit Callback

Beispiel
mdui.snackbar({
  message: 'Archived',
  buttonText: 'undo',
  onClick: function(){
    mdui.alert('Snackbar wurde geklickt');
  },
  onButtonClick: function(){
    mdui.alert('Button wurde geklickt');
  },
  onClose: function(){
    mdui.alert('Geschlossen');
  }
});

Snackbar an verschiedenen Positionen

Beispiel
mdui.snackbar({
  message: 'bottom',
  position: 'bottom',
});

mdui.snackbar({
  message: 'top',
  position: 'top',
});

mdui.snackbar({
  message: 'left-top',
  position: 'left-top',
});

mdui.snackbar({
  message: 'left-bottom',
  position: 'left-bottom',
});

mdui.snackbar({
  message: 'right-top',
  position: 'right-top',
});

mdui.snackbar({
  message: 'right-bottom',
  position: 'right-bottom',
});