Angular Toast-Benachrichtigungsservice | ng-hub-ui-toast
Standalone Angular Toast-Benachrichtigungsservice mit Signals, Lifecycle-Observables, Fortschrittsleiste, sechs Positionen und vollständigem Theming über CSS-Variablen.
API-Referenz
Hier ist der vollständige Vertrag für toast: alles, was du binden, abhören, projizieren und gestalten kannst, an einem Ort gesammelt. Verdrahte, was du brauchst, und gestalte, was du willst — es ist standalone und Signals-freundlich.
Inputs
Stelle toast mit 10 Inputs ein. Binde sie wie jeden Angular-@Input.
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
data (hub-toast)Erforderlich | HubToastData | — | Der zu rendernde Toast: id, Typ, Nachricht, optionaler Titel, aufgelöste Konfiguration und Lifecycle-Subjects. Wird intern von ToastContainerComponent bereitgestellt — normalerweise bindest du ihn nie selbst. |
timeOut / extendedTimeOut (config) | number | 5000 / 2500 | timeOut ist die Dauer in ms bis zum automatischen Ausblenden (0 = dauerhaft); extendedTimeOut ist die zusätzliche Zeit, die gewährt wird, nachdem der Benutzer den Mauszeiger vom Toast wegbewegt hat. |
closeButton / progressBar (config) | boolean | true / false | closeButton zeigt eine Schließen-Schaltfläche auf dem Toast; progressBar zeigt einen Balken, der bis zum automatischen Ausblenden herunterzählt. |
tapToDismiss (config) | boolean | true | Schließt den Toast, wenn der Benutzer irgendwo darauf klickt. |
disableTimeOut (config) | boolean | 'timeOut' | 'extendedTimeOut' | false | Deaktiviert das automatische Ausblenden: true oder 'timeOut' deaktiviert den anfänglichen Timer; 'extendedTimeOut' deaktiviert nur die Hover-Verlängerung. |
newestOnTop (config) | boolean | true | Wenn true, wird der neueste Toast oben im Stapel eingefügt statt unten. |
positionClass (config) | HubToastPosition | string | 'toast-top-right' | Bildschirmposition des Toast-Containers: eine der sechs eingebauten toast-top/bottom-left/center/right-Klassen oder ein benutzerdefinierter Klassen-String. |
maxOpened (config) | number | 0 | Maximale Anzahl gleichzeitig sichtbarer Toasts; 0 bedeutet unbegrenzt. |
autoDismiss (config) | boolean | false | Entfernt bei Erreichen von maxOpened automatisch den ältesten Toast, um Platz für den neuen zu schaffen. |
preventDuplicates (config) | boolean | false | Ignoriert einen neuen Toast, dessen Nachricht und Typ mit einem bereits sichtbaren übereinstimmen, und gibt stattdessen das Handle des vorhandenen Toasts zurück. |
Outputs
Reagiere darauf, was toast tut — 1 Events, an die du deine Logik anknüpfen kannst.
| Name | Typ | Beschreibung |
|---|---|---|
closed (hub-toast) | EventEmitter<number> | Gibt die Toast-id aus, wenn der Toast verworfen werden soll — nach Ablauf des Auto-Dismiss-Timers, einem Tippen mit tapToDismiss oder über die Schließen-Schaltfläche. |
Methoden
Steuere toast aus dem Code heraus — 7 Methoden auf der programmatischen Schnittstelle.
| Name | Signatur | Rückgabe | Beschreibung |
|---|---|---|---|
ToastService.success | success(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | Zeigt einen Erfolgs-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf. |
ToastService.error | error(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | Zeigt einen Fehler-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf. |
ToastService.warning | warning(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | Zeigt einen Warn-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf. |
ToastService.info | info(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | Zeigt einen Info-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf. |
ToastService.show | show(message: string, title?: string, config?: Partial<HubToastConfig>, type?: HubToastType | string): HubToastRef | HubToastRef handle for the created toast | Zeigt einen Toast mit einem eingebauten oder benutzerdefinierten Typ-String; der Typ wird als data-type auf dem Toast-Host angewendet und steuert das Akzent-Styling. |
ToastService.remove | remove(toastId: number): void | void | Entfernt einen bestimmten Toast anhand der id, die von den Show-Methoden zurückgegeben wird. |
ToastService.clear | clear(): void | void | Entfernt sofort alle aktiven Toasts und schließt dabei das onHidden-Observable jedes Toasts ab. |
Templates
Noch keine Templates dokumentiert.