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.

NameTypStandardBeschreibung
data (hub-toast)ErforderlichHubToastDataDer 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)number5000 / 2500timeOut 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)booleantrue / falsecloseButton zeigt eine Schließen-Schaltfläche auf dem Toast; progressBar zeigt einen Balken, der bis zum automatischen Ausblenden herunterzählt.
tapToDismiss (config)booleantrueSchließt den Toast, wenn der Benutzer irgendwo darauf klickt.
disableTimeOut (config)boolean | 'timeOut' | 'extendedTimeOut'falseDeaktiviert das automatische Ausblenden: true oder 'timeOut' deaktiviert den anfänglichen Timer; 'extendedTimeOut' deaktiviert nur die Hover-Verlängerung.
newestOnTop (config)booleantrueWenn 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)number0Maximale Anzahl gleichzeitig sichtbarer Toasts; 0 bedeutet unbegrenzt.
autoDismiss (config)booleanfalseEntfernt bei Erreichen von maxOpened automatisch den ältesten Toast, um Platz für den neuen zu schaffen.
preventDuplicates (config)booleanfalseIgnoriert 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.

NameTypBeschreibung
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.

NameSignaturRückgabeBeschreibung
ToastService.successsuccess(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastZeigt einen Erfolgs-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf.
ToastService.errorerror(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastZeigt einen Fehler-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf.
ToastService.warningwarning(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastZeigt einen Warn-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf.
ToastService.infoinfo(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastZeigt einen Info-Toast mit der angegebenen Nachricht, optionalem Titel und Konfigurations-Overrides je Aufruf.
ToastService.showshow(message: string, title?: string, config?: Partial<HubToastConfig>, type?: HubToastType | string): HubToastRefHubToastRef handle for the created toastZeigt 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.removeremove(toastId: number): voidvoidEntfernt einen bestimmten Toast anhand der id, die von den Show-Methoden zurückgegeben wird.
ToastService.clearclear(): voidvoidEntfernt sofort alle aktiven Toasts und schließt dabei das onHidden-Observable jedes Toasts ab.

Templates

Noch keine Templates dokumentiert.