Значения по умолчанию

Библиотека iziToast предоставляет гибкий и настраиваемый механизм для отображения уведомлений в веб-приложениях. Одним из ключевых аспектов её использования является понимание значений по умолчанию, которые определяют поведение уведомлений при минимальной конфигурации. Это позволяет быстро интегрировать библиотеку без необходимости задавать каждый параметр вручную.

Основные параметры

title – заголовок уведомления. По умолчанию не задан, то есть если параметр не указан, уведомление может отображаться только с текстом.

message – основной текст уведомления. Если параметр не задан, уведомление будет пустым, что обычно не имеет смысла, поэтому рекомендуется задавать хотя бы текст сообщения.

timeout – время отображения уведомления в миллисекундах. Значение по умолчанию: 5000. Если установить значение false, уведомление останется на экране до закрытия пользователем вручную.

theme – тема оформления уведомления. Возможные значения: 'light' (по умолчанию) и 'dark'. Тема определяет цвета фона, текста и иконок, влияя на визуальное восприятие уведомления.

color – основной цвет уведомления. Если не задан, используется стандартный цвет, соответствующий типу уведомления (например, 'green' для успешного уведомления, 'red' для ошибки).

icon – иконка уведомления. По умолчанию библиотека использует стандартные иконки для типов уведомлений:

  • success: fa fa-check-circle
  • error: fa fa-times-circle
  • warning: fa fa-exclamation-circle
  • info: fa fa-info-circle

position – позиция уведомления на экране. Значение по умолчанию: 'topRight'. Доступные варианты: 'topRight', 'topLeft', 'bottomRight', 'bottomLeft', 'topCenter', 'bottomCenter'.

progressBar – индикатор времени отображения. По умолчанию: true. Отображается горизонтальная полоска, уменьшающаяся с течением времени, показывая пользователю, сколько времени осталось до закрытия уведомления.

close – возможность закрытия уведомления. Значение по умолчанию: true. Если отключить, крестик для закрытия уведомления не отображается.

animateInside – анимация содержимого уведомления. По умолчанию: true, что делает появление и исчезновение текста и иконок плавным.

transitionIn / transitionOut – анимации появления и скрытия уведомления. По умолчанию: 'fadeInDown' для входа и 'fadeOutUp' для выхода. Позволяют визуально управлять динамикой уведомления, не вмешиваясь в CSS напрямую.

Пример использования значений по умолчанию

iziToast.show({
    title: 'Пример',
    message: 'Это уведомление использует значения по умолчанию',
});

В этом примере уведомление появится в правом верхнем углу, с светлой темой, зеленой иконкой успеха, и автоматически скроется через 5 секунд.

Настройка поведения через глобальные значения

Библиотека позволяет задавать глобальные настройки, которые будут применяться ко всем уведомлениям:

iziToast.settings({
    timeout: 8000,
    position: 'bottomRight',
    theme: 'dark',
    progressBar: false
});

После такой настройки каждое уведомление будет отображаться 8 секунд, в правом нижнем углу, с темной темой и без индикатора прогресса, если явно не переопределить параметры при вызове show().

Важные особенности

  • Параметры по умолчанию обеспечивают совместимость с большинством стандартных сценариев, позволяя создавать уведомления без глубокого изучения библиотеки.
  • Локальная переопределяемость: любой параметр можно задать при конкретном вызове уведомления, и он будет иметь приоритет над глобальными настройками.
  • Сочетание значений: можно комбинировать глобальные настройки с локальными для частичной кастомизации, сохраняя при этом общую консистентность интерфейса.

Знание и понимание значений по умолчанию критически важно для грамотного использования iziToast, так как оно сокращает количество кода и обеспечивает предсказуемое поведение уведомлений в приложении.

Оглавление