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

Toastify — это легковесная JavaScript-библиотека для создания уведомлений (toasts) на веб-страницах. При использовании библиотеки важно понимать, какие значения по умолчанию применяются, чтобы корректно управлять поведением уведомлений без необходимости явно указывать все параметры.

Настройка уведомлений

При создании уведомления через Toastify({...}) можно передать объект конфигурации с различными свойствами. Если какое-либо свойство не указано, библиотека использует заранее определённое значение по умолчанию. Это позволяет быстро создавать уведомления без перегрузки кода параметрами.

Пример базового вызова:

Toastify({
    text: "Пример уведомления"
}).showToast();

В этом случае уведомление появится с настройками по умолчанию для позиции, длительности, стиля и поведения.

Основные свойства и их значения по умолчанию

1. text

  • Тип: string
  • Описание: Текст уведомления, обязательный параметр.
  • Значение по умолчанию отсутствует — уведомление не отобразится без текста.

2. duration

  • Тип: number (миллисекунды)
  • Значение по умолчанию: 3000
  • Описание: Время отображения уведомления до автоматического исчезновения.
  • Пример:
Toastify({ text: "Тест", duration: 5000 }).showToast();

3. destination

  • Тип: string (URL)
  • Значение по умолчанию: null
  • Описание: Если указать ссылку, клик по уведомлению откроет её.
  • Пример использования по умолчанию: уведомление без перехода.

4. newWindow

  • Тип: boolean
  • Значение по умолчанию: true
  • Описание: Определяет, откроется ли ссылка в новом окне/вкладке при клике.

5. close

  • Тип: boolean
  • Значение по умолчанию: false
  • Описание: Показывать ли кнопку закрытия уведомления.

6. gravity

  • Тип: string ("top" или "bottom")
  • Значение по умолчанию: "top"
  • Описание: Вертикальное положение уведомления на экране.

7. position

  • Тип: string ("left", "center", "right")
  • Значение по умолчанию: "right"
  • Описание: Горизонтальное выравнивание уведомления.

8. backgroundColor

  • Тип: string (CSS-цвет)
  • Значение по умолчанию: null
  • Описание: Цвет фона уведомления. При отсутствии значения используется встроенный стиль по умолчанию.

9. stopOnFocus

  • Тип: boolean
  • Значение по умолчанию: true
  • Описание: При наведении курсора на уведомление таймер скрытия останавливается.

10. onClick

  • Тип: function
  • Значение по умолчанию: null
  • Описание: Функция, вызываемая при клике на уведомление.

11. onClose

  • Тип: function
  • Значение по умолчанию: null
  • Описание: Функция, вызываемая при закрытии уведомления, будь то автоматическое или через кнопку закрытия.

Примеры работы с дефолтными значениями

Создание уведомления с минимальными параметрами:

Toastify({ text: "Сообщение по умолчанию" }).showToast();
  • Появляется в верхнем правом углу.
  • Длительность: 3 секунды.
  • Автоматически исчезает, останавливается при наведении.
  • Нет кнопки закрытия и ссылки.

Переопределение части дефолтных значений:

Toastify({
    text: "Внимание!",
    duration: 5000,
    gravity: "bottom",
    position: "center",
    close: true
}).showToast();
  • Уведомление показывается внизу по центру.
  • Длительность увеличена до 5 секунд.
  • Добавлена кнопка закрытия.
  • Остальные свойства используют значения по умолчанию.

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

  1. Совмещение свойств: значения по умолчанию позволяют комбинировать пользовательские параметры с готовыми настройками, упрощая управление уведомлениями.
  2. Минимализм кода: можно создавать быстрые уведомления без полного набора свойств, при этом поведение остаётся предсказуемым.
  3. Переопределение: любое свойство, если его явно указать, заменяет дефолтное значение, что даёт полный контроль над внешним видом и поведением.

Итог по значениям по умолчанию

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

Оглавление