Метод close()

Метод close() предназначен для программного закрытия уведомления, созданного с помощью библиотеки Noty. Он является ключевым инструментом управления жизненным циклом уведомлений, позволяя завершить их отображение по событиям, отличным от стандартного таймера автоудаления.

Синтаксис

notyInstance.close();
  • notyInstance — объект уведомления, созданный через new Noty({...}).
  • Метод не принимает аргументов.
  • После вызова close() уведомление плавно исчезает с экрана с применением анимации, указанной в настройках.

Особенности работы

  1. Анимация закрытия Метод автоматически применяет конфигурацию анимации animation.close из параметров уведомления. Если анимация отключена или отсутствует, уведомление исчезает мгновенно.

  2. Отмена повторного закрытия Вызов close() у уже закрывающегося уведомления не приводит к ошибкам. Метод игнорирует повторные вызовы, что предотвращает дублированные события и исключения.

  3. Вызов событий При закрытии уведомления триггерятся стандартные события:

    • onClose — вызывается непосредственно перед удалением уведомления из DOM.
    • onClosed — вызывается после завершения анимации и удаления уведомления.

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

Примеры использования

1. Простое закрытие уведомления
let myNotification = new Noty({
    text: 'Произошло важное событие',
    type: 'alert',
    timeout: false
}).show();

// Закрытие через 3 секунды
setTimeout(() => {
    myNotification.close();
}, 3000);

В этом примере уведомление не исчезает автоматически (timeout: false), а закрывается через 3 секунды вручную.

2. Закрытие уведомления по событию
let myNotification = new Noty({
    text: 'Данные сохранены',
    type: 'success'
}).show();

document.getElementById('closeButton').addEventListener('click', () => {
    myNotification.close();
});

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

3. Использование с событиями onClose и onClosed
let myNotification = new Noty({
    text: 'Процесс завершен',
    type: 'information',
    callbacks: {
        onClose: function() {
            console.log('Уведомление начинает закрываться');
        },
        onClosed: function() {
            console.log('Уведомление закрыто и удалено');
        }
    }
}).show();

myNotification.close();

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

Отличия от автоматического закрытия

Метод close() отличается от автоматического закрытия timeout тем, что:

  • Не зависит от установленного времени отображения.
  • Позволяет закрывать уведомление по произвольным условиям.
  • Гарантирует вызов событий onClose и onClosed, даже если уведомление ещё не завершило свой таймер.

Советы по использованию

  • Использовать close() для уведомлений без таймера (timeout: false) или при необходимости мгновенного завершения.
  • Применять вместе с колбэками для синхронизации интерфейса.
  • Проверять состояние уведомления перед повторным вызовом метода, чтобы избежать лишних операций.

Метод close() обеспечивает полный контроль над удалением уведомлений, делая библиотеку Noty гибкой и удобной для динамических интерфейсов. Его использование особенно важно в сложных приложениях, где уведомления должны реагировать на действия пользователя или события системы.

Оглавление