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.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
message | string | ja | Die angezeigte Nachricht. |
title | string | nein | Optionaler Titel der Benachrichtigung. |
options | ToastrOptions | nein | Optionale Konfiguration (siehe unten). |
RAGAI.toastr.success('Bot gespeichert');
RAGAI.toastr.success('Einstellungen übernommen', 'Erfolg');
.error(message, title?, options?)
Zeigt eine rote Fehler-Benachrichtigung an.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
message | string | ja | Die angezeigte Fehlernachricht. |
title | string | nein | Optionaler Titel. |
options | ToastrOptions | nein | Optionale 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.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
message | string | ja | Die angezeigte Information. |
title | string | nein | Optionaler Titel. |
options | ToastrOptions | nein | Optionale 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.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
message | string | ja | Die angezeigte Warnung. |
title | string | nein | Optionaler Titel. |
options | ToastrOptions | nein | Optionale 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: boolean — Standard: false
{ closeButton: true }
timeOut
Zeit in Millisekunden, wie lange die Benachrichtigung angezeigt wird.
Typ: number — Standard: 5000
{ timeOut: 3000 }
extendedTimeOut
Zeit in Millisekunden, wie lange die Benachrichtigung nach Maus-Hover noch angezeigt wird.
Typ: number — Standard: 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: number — Standard: 300
{ easeTime: 500 }
enableHtml
Wenn true, wird der Nachrichtentext als HTML interpretiert.
Typ: boolean — Standard: false
{ enableHtml: true }
newestOnTop
Die neueste Benachrichtigung wird im Vordergrund angezeigt.
Typ: boolean — Standard: true
{ newestOnTop: false }
progressBar
Zeigt eine Fortschrittsanzeige über die verbleibende Anzeigedauer.
Typ: boolean — Standard: false
{ progressBar: true }
progressAnimation
Richtung der Fortschrittsanimation.
Typ: 'decreasing' | 'increasing' — Standard: 'decreasing'
{ progressAnimation: 'increasing' }
positionClass
Position der Benachrichtigung auf der Seite.
Typ: string — Standard: '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: boolean — Standard: 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
});