Параметр duration

Параметр duration в библиотеке Toastify определяет время отображения уведомления на экране. Это одно из ключевых свойств при настройке поведения тостов, так как оно напрямую влияет на пользовательский опыт: слишком короткое время не позволит прочитать сообщение, слишком длинное — будет отвлекать.

Синтаксис

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

Здесь duration задаётся в миллисекундах. Значение 3000 означает, что тост будет видим 3 секунды. После истечения времени уведомление автоматически исчезает.

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

Если параметр duration не задан, Toastify использует стандартное время отображения тоста — 3000 мс. Это значение оптимально для кратких уведомлений, но при необходимости можно его изменять.

Бесконечное отображение

Для случаев, когда уведомление должно оставаться на экране до явного закрытия, duration можно установить в -1 или Infinity. В этом режиме тост не исчезает автоматически и закрывается только с помощью кнопки закрытия или программного вызова метода .hideToast().

Toastify({
  text: "Тост без автоудаления",
  duration: -1
}).showToast();

Динамическая настройка

Параметр duration может быть установлен динамически на основе условий приложения. Например, для ошибок или предупреждений время отображения можно увеличить:

let messageDuration = error ? 5000 : 2000;

Toastify({
  text: "Сообщение об ошибке",
  duration: messageDuration
}).showToast();

Взаимодействие с другими параметрами

duration тесно связан с параметрами close и gravity:

  • close: при включении кнопки закрытия тост можно убрать вручную, даже если duration ещё не истёк. В этом случае фактическое время отображения может быть меньше указанного.
  • gravity и position: визуальное расположение не влияет на длительность, но влияет на восприятие времени — тосты в верхней части экрана воспринимаются быстрее, чем снизу.

Особенности плавного исчезновения

Toastify автоматически применяет анимацию исчезновения по истечении duration. При этом фактическое время видимости тоста может немного отличаться от указанного, так как анимация добавляет небольшую задержку (обычно 300–500 мс).

Практические рекомендации

  • Для информационных уведомлений: 2000–3000 мс.
  • Для предупреждений или ошибок: 4000–6000 мс.
  • Для тостов с кнопкой действий или ссылками: использовать -1 и закрывать вручную.

Настройка duration позволяет создавать гибкие уведомления, адаптированные к контексту приложения и важности информации, делая взаимодействие с пользователем более естественным и комфортным.

Оглавление