Falls nicht bereits vorhanden, muss eine Jquery Library eingebunden werden. Entweder du lädst dir diese von den entsprechenden Seiten selber herrunter oder du bindest den folgenden Codeschnipsel in deine Datei ein.
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
Zum Schluss müssen noch die Dateien jquery.toast.css und jquery.toast.js in die Datei eingebunden werden
<link rel="stylesheet" href="jquery.toast.css">
<script src="jquery.toast.js"></script>
Hinweis: Achte drauf, dass die Pfade zu den Dateien stimmen.
1. Anzeige einens Ladebalkens.
Der Ladebalken ist standardmäßig aktiviert. Verwende die Optionen `loader` und` loaderBg`, um ihn zu deaktivieren oder die Farbe zu ändern. Schaue dir die Beispiele unten an
$.toast({
heading: 'Information',
text: 'Ladebalken sind standardmäßig aktiviert. Verwende `loader`,` loaderBg`, um das Standardverhalten zu ändern ',
icon: 'info',
loader: true, // Ändere es in false, um den Ladebalken zu deaktivieren
loaderBg: '#9EC600' // Hintergrundfarbe vom Ladebalken
})
2. Optionaler Schließ Button.
Der optionale Schließ Button ist standardmäßig aktiviert, wird aber nur bei einer Texteingabe bei `btText` unter dem Toast Text angezeigt.
$.toast({
heading: 'Information',
text: 'Der optionale Schließ Button ist standardmäßig aktiviert, wird aber nur bei einer Texteingabe bei `btText` unter dem Toast Text angezeigt.',
icon: 'info',
btText: 'Toast schließen', // Text auf dem Button
hideAfter: 6000
})
Um einen einfachen Toast zu generieren, kannst du einfach den Code der Beispiele kopieren
$.toast('Hier kannst du den Text des Toasts einfügen')
Es gibt verschiedene Arten von Toasts:
$.toast({
heading: 'Information',
text: 'Jetzt kkannst du Symbole hinzufügen, um verschiedene Arten von Toast zu generieren',
showHideTransition: 'slide',
icon: 'info'
})
$.toast({
heading: 'Error',
text: 'Es ist leider ein Fehler aufgetreten!',
showHideTransition: 'fade',
icon: 'error'
})
$.toast({
heading: 'Warnung',
text: 'Der Toaster lässt sich sehr einfach bedienen!',
showHideTransition: 'plain',
icon: 'warning'
})
$.toast({
heading: 'Erfolgreich',
text: 'Das waren nur die grundlegenden Beispiels! Scrolle nach unten, um weitere Details zu sehen.',
showHideTransition: 'slide',
icon: 'success'
})
Natürlich ist das nicht alles, was du mit diesem Plugin tun kannst. Es gibt viele weitere Optionen. Beginnen wir damit, jede Option einzelnd zu erklären
Du solltest beachten, dass du bei jeder Verwendung von Optionen ein Optionsobjekt übergibst und der Text wie folgt angeben werden muss:
$.toast({
text: 'Dies wird die Toastnachricht'
})
Der Text kann ein Array sein:
$.toast({
heading: 'Ist der Toast nützlich?',
text: [
'Ja',
'Nein',
'Vielleicht'
],
icon: 'info'
})
Or put some HTML in the text
$.toast({
heading: 'Kann ich <em>HTML</em> benutzen?',
text: '<b>Ja, kein Problem</b>',
hideAfter: false,
icon: 'success'
})
Mit der Option heading kannst du die Überschrift der Toastnachricht angeben.
$.toast({
heading: 'Überschrift',
text: 'Mit der Option `heading` kannst du die Überschrift der Toastnachricht angeben.',
})
Manchmal möchte man Toasts anheften. Um sie anzuheften muss man hideAfter auf false setzen. Dies ist ein angehefteter Toast.
$.toast({
text: 'Setze `hideAfter` auf false und der Toast wird angeheftet.',
hideAfter: false
})
Mit der Option hideAfter kann der Timer geändert werden, nach dem Toast ausgeblendet werden soll. Der Timer muss dann in Millisekunden angeben werden.
$.toast({
text: 'Setze die Option `hideAfter` auf Millisekunden, und der Toast wird nach den angegebenen Millisekunden ausgeblendet.',
hideAfter: 5000 // in Millisekunden
})
Mit der Option showHideTransition kann die Animation festlegt werden. Folgende Einstellungen stehen zur Verfügung:
$.toast({
text: 'Setze die Option `showHideTransition` auf fade|plain|slide um die jeweilige Animationen einzustellen.',
heading: 'Animation nach oben und unten',
showHideTransition: 'slide'
})
$.toast({
text: 'Setze die Option `showHideTransition` auf fade|plain|slide um die jeweilige Animationen einzustellen.',
heading: 'Einfache Animation',
showHideTransition: 'fade'
})
$.toast({
text: 'Setze die Option `showHideTransition` auf fade|plain|slide um die jeweilige Animationen einzustellen.',
heading: 'Ein- und Ausblenden zur Ecke',
showHideTransition: 'plain'
})
Mit der Option allowToastClose wird eingestellt, ob ein Toast schließbar ist oder nicht. Es wird ein kleiner Kreuzknopf zum anklicken ein- oder ausblendet
$.toast({
heading: 'Schließbarer Toast',
text: 'Setze die Option `allowToastClose`auf true|false um den Toast schließbar zu machen oder nicht',
allowToastClose: true
})
$.toast({
heading: 'Nicht schließbarer Toast',
text: 'Setze die Option `allowToastClose`auf true|false um den Toast schließbar zu machen oder nicht',
allowToastClose: false
})
Mit der stack Option wird festgelegt, wie viele Toasts gleichzeitig angezeigt werden können. Standardmäßig ist diese Option auf 5 eingestellt.
$.toast({
heading: 'Festgelegte Anzahl von Toasts',
text: 'Wenn eine Zahl festgelegt ist, wird maximal die festgelegte Anzahl von Toasts gleichzeitig angezeigt.',
stack: 4
})
$.toast({
heading: 'Kein Toaststapel',
text: 'Wenn false festgelegt ist, wird jeweils nur ein Toast angezeigt.',
stack: false
})
Hinweis: Klicke mehrmals auf die Schaltfläche `Toast anzeigen`, um diese Beispiels zu testen.
Die Option position kann verwendet werden, um die Position des Toasts anzugeben. Es gibt folgende vordefinierte Positionen:
$.toast().reset('all');$.toast({
heading: 'Unten Links',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'bottom-left',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Unten Rechts',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'bottom-right',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Unten Mitte',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'bottom-center',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Oben Links',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'top-left',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Oben Rechts',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'top-right',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Oben Mitte',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'top-center',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Mitte der Seite',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: 'mid-center',
stack: false
})
$.toast().reset('all');$.toast({
heading: 'Benutzerdefinierte Position',
text: 'Gib die benutzerdefinierte Position ein oder nutze eine der Vordefinierten.',
position: {
left: 120,
top: 120
},
stack: false
})
Hinweis: Es ist zu beachten, dass nach dem Ändern der Toastposition mit Hilfe der Eigenschaft `position` die Position für die nächsten Toasts zurückgesetzt werden muss, wenn diese an ihrer Standardposition angezeigt werden sollen, d. H. In der unteren linken Ecke. Andernfalls wird jeder neu erzeugte Toast an der letzten Position angezeigt, d. H. An der Stelle, an der der zuletzt positionierte Toast angezeigt wurde. Du kannst die Toastposition zurücksetzen mit:
$.toast().reset('all');
Mit der Option icon können die vordefinierten Toasttypen angegeben werden. Es folgen die vordefinierten Typen:
$.toast({
heading: 'Warnung',
text: 'Ein Toast mit Warnung Icon.',
icon: 'warning'
})
$.toast({
heading: 'Erfolg',
text: 'Ein Toast mit Erfolg Icon.',
icon: 'success'
})
$.toast({
heading: 'Fehler',
text: 'Ein Toast mit Fehler Icon.',
icon: 'error'
})
$.toast({
heading: 'Information',
text: 'Ein Toast mit Information Icon.',
icon: 'info'
})
Mit der bgColor Option wird die Hintergrundfarbe des Toasts eingestellt. Standard ist '#444'
$.toast({
heading: 'Farben',
text: 'Farben werden mit den Optionen `bgColor` and `textColor` eingestellt.',
bgColor: '#FF1356',
textColor: '#FFFFFF'
})
Die Option textAlign wird verwendet, um die Ausrichtung von Text innerhalb des Toasts festzulegen. Zulässige Werte sind:
$.toast({
text: 'Dieser Text ist linksbündig',
textAlign: 'left'
})
$.toast({
text: 'Dieser Text ist rechtsbündig',
textAlign: 'right'
})
$.toast({
text: 'Dieser Text ist zentriert',
textAlign: 'center'
})
Die Option class wird verwendet, um dem Toast benutzerdefinierte Klassen hinzuzufügen.
$.toast({
heading: 'Benutzerdefinierte Klasse',
text: 'Benutzerdefinierte Klassen werden mit der Option `class` angegeben.',
class: 'larger-font'
})
Toast macht die folgenden Ereignisse verfügbar, damit du alles einbinden kannst, was du möchtest.
$.toast({
text: 'Löst die Ereignisse aus',
beforeShow: function () {
alert('Der Toast ist im Begriff zu erscheinen.');
},
afterShown: function () {
alert('Der Toast ist erschienen.');
},
beforeHide: function () {
alert('Der Toast ist im Begriff, sich zu verstecken.');
},
afterHidden: function () {
alert('Der Toast wurde versteckt.');
}
})
Wenn du einen Verweis auf einen Toast hast und diesen aktualisieren möchtest, kannst du dies tun, indem du die Option update für die Instanz aufrufst.
var myToast = $.toast({
heading: 'Information',
text: 'Hier ist eine Informationen, die später in einen Fehler umgewandelt wird.',
icon: 'info',
hideAfter: false
});
// Update the toast after three seconds.
window.setTimeout(function(){
myToast.update({
heading: 'Fehler',
text: 'Hier ist eine Information, die sich in Fehler geändert hat.',
icon: 'error',
hideAfter: false
});
}, 3000)
Wenn du den Verweis auf einen bestimmten Toast hast, kannst du diesen wie folgt zurücksetzen:
var myToast = $.toast('Toast, die entfernt werden müssen.');
myToast.reset(); // Entfernt die Toasts 'Toast, die entfernt werden müssen.'
Wenn du nicht auf einen bestimmten Toast verweisen und jeden Toast zurücksetzen möchtst, gehen wie folgt vor:
$.toast().reset('all');