ngx-toastr — библиотека уведомлений (toasts) для приложений на Angular, предназначенная для простого создания и отображения кратковременных всплывающих сообщений пользователю. Проект реализует механизмы управления жизненным циклом уведомлений, их позиционирования, стилей и анимаций, предоставляя декларативный API, совместимый с архитектурой Angular и его системой зависимостей. Библиотека служит клиентской реализацией паттерна уведомлений в веб-интерфейсах, где требуется ненавязчиво информировать о результатах действий, ошибках или системных событиях.
Исторически ngx-toastr возник как адаптация концепций уведомлений из популярных JavaScript-решений под экосистему Angular с поддержкой TypeScript, модульности и инъекции зависимостей. В документации и примерах обычно показаны способы регистрации модуля в корневом модуле приложения, использование сервиса для создания простых и кастомных тостов, а также конфигурация по умолчанию для позиционирования, продолжительности и визуальных эффектов. В случаях, когда официальной информации недостаточно, общая функциональность описывается на основе типичных реализаций подобных библиотек: отправка уведомлений программно, шаблонные и компонентные тосты, управление очередью и повторным отображением.
- Отображение уведомлений: простое создание стандартных тостов с заголовком и текстом через сервис, удобное программное API для отправки сообщений из компонентов и сервисов приложения.
- Позиционирование: выбор области экрана для появления тостов (верхний/нижний углы, центр и т. п.) с возможностью настройки отступов и порядка появления.
- Время жизни и управление: конфигурация продолжительности показа уведомления, опции автоматического закрытия, ручного закрытия и возможность очистки всех тостов программно.
- Анимации: встроенная поддержка анимаций появления и скрытия, обычно на базе CSS-анимаций или Angular анимаций, с возможностью включения/отключения и настройки эффектов.
- Кастомные тосты: возможность рендеринга пользовательских компонентов внутри уведомлений для сложного контента, включая кнопки действий и интерактивные элементы.
- Конфигурация по умолчанию: глобальные параметры модуля для задания стилей, длительности, максимального числа одновременно отображаемых тостов и поведения очереди.
- Темизация и стили: поддержка базированных на CSS тем и классов для изменения внешнего вида уведомлений без вмешательства в логику их отображения.
- Интеграция с Angular: регистрация через NgModule, использование сервисов через dependency injection и совместимость с зоной выполнения Angular для корректного обновления представления.
- Управление при навигации: опции для сохранения или очистки уведомлений при смене маршрута в одностраничном приложении.
- Обработка ошибок и статусы: стандартные типы сообщений (успех, информация, предупреждение, ошибка) для семантической классификации уведомлений.