Skip to main content

toastr

Mit dem toastr-Service kannst du dem Nutzer dynamisch Benachrichtigungen (Toasts) am Seitenrand anzeigen. Es stehen vier Benachrichtigungstypen zur Verfügung: Erfolg, Fehler, Info und Warnung.


.success(message, title?, options?)

Zeigt eine grüne Erfolgs-Benachrichtigung an.

ParameterTypPflichtBeschreibung
messagestringjaDie angezeigte Nachricht.
titlestringneinOptionaler Titel der Benachrichtigung.
optionsToastrOptionsneinOptionale Konfiguration (siehe unten).
RAGAI.toastr.success('Bot gespeichert');
RAGAI.toastr.success('Einstellungen übernommen', 'Erfolg');

.error(message, title?, options?)

Zeigt eine rote Fehler-Benachrichtigung an.

ParameterTypPflichtBeschreibung
messagestringjaDie angezeigte Fehlernachricht.
titlestringneinOptionaler Titel.
optionsToastrOptionsneinOptionale Konfiguration.
RAGAI.toastr.error('Das Speichern ist fehlgeschlagen. Versuche es erneut.');
RAGAI.toastr.error('Keine Berechtigung für diese Aktion', 'Fehler');

.info(message, title?, options?)

Zeigt eine blaue Info-Benachrichtigung an.

ParameterTypPflichtBeschreibung
messagestringjaDie angezeigte Information.
titlestringneinOptionaler Titel.
optionsToastrOptionsneinOptionale Konfiguration.
RAGAI.toastr.info('Text kopiert');
RAGAI.toastr.info('Neue Version verfügbar', 'Hinweis');

.warning(message, title?, options?)

Zeigt eine gelb-orange Warn-Benachrichtigung an.

ParameterTypPflichtBeschreibung
messagestringjaDie angezeigte Warnung.
titlestringneinOptionaler Titel.
optionsToastrOptionsneinOptionale Konfiguration.
RAGAI.toastr.warning('Zu viele Anfragen. Bitte warte einen Moment.');
RAGAI.toastr.warning('Sitzung läuft bald ab', 'Warnung');

ToastrOptions

Jede der oben genannten Methoden akzeptiert ein optionales Options-Objekt zur Konfiguration der Benachrichtigung. Die folgenden Werte zeigen jeweils den Standard.

closeButton

Zeigt ein Schließen-Symbol (x) in der Benachrichtigung an.

Typ: booleanStandard: false

{ closeButton: true }

timeOut

Zeit in Millisekunden, wie lange die Benachrichtigung angezeigt wird.

Typ: numberStandard: 5000

{ timeOut: 3000 }

extendedTimeOut

Zeit in Millisekunden, wie lange die Benachrichtigung nach Maus-Hover noch angezeigt wird.

Typ: numberStandard: 1000

{ extendedTimeOut: 2000 }

disableTimeOut

Deaktiviert die Zeitbegrenzung – entweder komplett oder nur für eine der beiden TimeOut-Optionen.

Typ: boolean | 'timeOut' | 'extendedTimeOut'Standard: false

{ disableTimeOut: true }
{ disableTimeOut: 'extendedTimeOut' }

easeTime

Dauer der Ein-/Ausblende-Animation in Millisekunden.

Typ: numberStandard: 300

{ easeTime: 500 }

enableHtml

Wenn true, wird der Nachrichtentext als HTML interpretiert.

Typ: booleanStandard: false

{ enableHtml: true }

newestOnTop

Die neueste Benachrichtigung wird im Vordergrund angezeigt.

Typ: booleanStandard: true

{ newestOnTop: false }

progressBar

Zeigt eine Fortschrittsanzeige über die verbleibende Anzeigedauer.

Typ: booleanStandard: false

{ progressBar: true }

progressAnimation

Richtung der Fortschrittsanimation.

Typ: 'decreasing' | 'increasing'Standard: 'decreasing'

{ progressAnimation: 'increasing' }

positionClass

Position der Benachrichtigung auf der Seite.

Typ: stringStandard: 'toast-top-right'

Mögliche Werte: 'toast-top-right', 'toast-top-left', 'toast-top-full-width', 'toast-top-center', 'toast-bottom-right', 'toast-bottom-left', 'toast-bottom-full-width', 'toast-bottom-center'

{ positionClass: 'toast-top-center' }

tapToDismiss

Wenn true, muss der Nutzer die Benachrichtigung anklicken, damit sie verschwindet.

Typ: booleanStandard: true

{ tapToDismiss: false }

Beispiel mit kombinierten Optionen

RAGAI.toastr.success('Daten erfolgreich gespeichert', 'Gespeichert', {
closeButton: true,
positionClass: 'toast-top-center',
timeOut: 3000,
disableTimeOut: 'extendedTimeOut',
progressBar: true
});