Сервис Toast-уведомлений для Angular | ng-hub-ui-toast

Standalone-сервис toast-уведомлений для Angular с Signals, observable жизненного цикла, индикатором прогресса, шестью позициями и полной темизацией через CSS-переменные.

Справочник API

Вот полный контракт toast: всё, что можно привязать, прослушать, спроецировать и тематизировать, собрано в одном месте. Подключите то, что нужно, и оформите так, как хотите — это standalone и дружит с сигналами.

Входные свойства

Настройте toast с помощью 10 входных свойств. Привязывайте их, как любой @Input в Angular.

ИмяТипПо умолчаниюОписание
data (hub-toast)ОбязательноHubToastDataToast для отрисовки: id, тип, сообщение, необязательный заголовок, итоговая конфигурация и объекты Subject жизненного цикла. Предоставляется внутренне компонентом ToastContainerComponent — обычно вы никогда не привязываете его сами.
timeOut / extendedTimeOut (config)number5000 / 2500timeOut — длительность в мс до автоматического скрытия (0 = постоянный toast); extendedTimeOut — дополнительное время, предоставляемое после того, как пользователь уводит курсор с toast.
closeButton / progressBar (config)booleantrue / falsecloseButton показывает кнопку закрытия на toast; progressBar показывает полосу обратного отсчёта до автоматического скрытия.
tapToDismiss (config)booleantrueЗакрывает toast, когда пользователь кликает в любом его месте.
disableTimeOut (config)boolean | 'timeOut' | 'extendedTimeOut'falseОтключает автоматическое скрытие: true или 'timeOut' отключает начальный таймер; 'extendedTimeOut' отключает только продление после наведения.
newestOnTop (config)booleantrueЕсли true, самый новый toast вставляется сверху стека, а не снизу.
positionClass (config)HubToastPosition | string'toast-top-right'Позиция контейнера toast на экране: один из шести встроенных классов toast-top/bottom-left/center/right или строка пользовательского класса.
maxOpened (config)number0Максимальное число одновременно видимых toast; 0 означает без ограничений.
autoDismiss (config)booleanfalseПри достижении maxOpened автоматически удаляет самый старый toast, освобождая место для нового.
preventDuplicates (config)booleanfalseИгнорирует новый toast, чьи сообщение и тип совпадают с уже видимым, возвращая вместо этого дескриптор существующего toast.

События

Реагируйте на то, что делает toast, — 1 событий, к которым можно подключить вашу логику.

ИмяТипОписание
closed (hub-toast)EventEmitter<number>Испускает id toast, когда toast должен быть скрыт — по таймеру автоматического скрытия, по клику при tapToDismiss или по кнопке закрытия.

Методы

Управляйте toast из кода — 7 методов его программного интерфейса.

ИмяСигнатураВозвращаетОписание
ToastService.successsuccess(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastПоказывает toast успеха с указанным сообщением, необязательным заголовком и переопределениями конфигурации для конкретного вызова.
ToastService.errorerror(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastПоказывает toast ошибки с указанным сообщением, необязательным заголовком и переопределениями конфигурации для конкретного вызова.
ToastService.warningwarning(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastПоказывает toast предупреждения с указанным сообщением, необязательным заголовком и переопределениями конфигурации для конкретного вызова.
ToastService.infoinfo(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRefHubToastRef handle for the created toastПоказывает информационный toast с указанным сообщением, необязательным заголовком и переопределениями конфигурации для конкретного вызова.
ToastService.showshow(message: string, title?: string, config?: Partial<HubToastConfig>, type?: HubToastType | string): HubToastRefHubToastRef handle for the created toastПоказывает toast со встроенной или пользовательской строкой типа; тип применяется как data-type на хосте toast и определяет акцентную стилизацию.
ToastService.removeremove(toastId: number): voidvoidУдаляет конкретный toast по id, возвращённому методами показа.
ToastService.clearclear(): voidvoidНемедленно удаляет все активные toast, завершая Observable onHidden каждого toast.

Шаблоны

Шаблоны пока не задокументированы.