Параметр beforeClose

tingle.js — это простая, но мощная JavaScript-библиотека для создания модальных окон. В процессе работы с модальными окнами часто возникает необходимость выполнить некоторые действия перед их закрытием, такие как сохранение данных или анимация. Для таких случаев в tingle.js предусмотрен параметр beforeClose.

Определение параметра `beforeClose`

Параметр beforeClose — это функция-обработчик, которая вызывается перед закрытием модального окна. Она даёт возможность выполнить различные действия, такие как проверка состояния данных или запуск анимации, перед тем как окно будет действительно закрыто. Функция, переданная в beforeClose, должна вернуть true, если окно должно быть закрыто, или false, если закрытие необходимо отменить.

Синтаксис использования

const modal = new tingle.modal({
  beforeClose: function () {
    // Логика, которую нужно выполнить перед закрытием модального окна
    if (условие) {
      return true;  // Окно закрывается
    } else {
      return false; // Закрытие окна отменяется
    }
  }
});

Функция beforeClose будет вызвана непосредственно перед закрытием модального окна. Если она вернёт false, окно не закроется, и можно выполнить дополнительные действия для решения возникшей проблемы.

Структура параметра

Параметр beforeClose — это функция, которая не принимает аргументов и должна вернуть одно из двух значений:

true: Закрытие модального окна разрешено.
false: Закрытие модального окна отменено.

В процессе работы с модальными окнами важным моментом является то, что beforeClose может асинхронно обрабатывать действия. Например, в случае необходимости выполнения AJAX-запроса или ожидания какого-либо события можно использовать Promise.

Пример с асинхронной функцией

const modal = new tingle.modal({
  beforeClose: async function () {
    // Эмуляция асинхронной задачи (например, AJAX-запрос)
    const result = await someAsyncTask();
    
    if (result.success) {
      return true;
    } else {
      return false;
    }
  }
});

Здесь someAsyncTask — это асинхронная функция, которая, например, может делать запрос к серверу. Только после выполнения задачи будет решено, можно ли закрывать окно.

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

Подтверждение перед закрытием:

Часто необходимо попросить пользователя подтвердить действие перед закрытием окна. Например, если он не сохранил изменения, можно запросить подтверждение.
```
const modal = new tingle.modal({
  beforeClose: function () {
    const isDataSaved = checkIfDataSaved();
    if (!isDataSaved) {
      return confirm('Есть несохранённые изменения. Вы уверены, что хотите закрыть?');
    }
    return true;
  }
});
```
В этом примере перед закрытием окна проверяется, были ли сохранены данные. Если данные не сохранены, пользователь будет уведомлён о необходимости сохранить их перед закрытием.
Анимация закрытия:

Иногда необходимо выполнить анимацию перед тем, как окно закроется. Для этого можно использовать параметр beforeClose.
```
const modal = new tingle.modal({
  beforeClose: function () {
    animateClose();
    return true;  // Возвращаем true после завершения анимации
  }
});
```
В этом примере перед закрытием окна выполняется анимация. Закрытие окна происходит после её завершения.
Отмена закрытия на основе данных:

В некоторых случаях перед закрытием необходимо проверить состояние данных, например, если пользователь заполнил форму, но не подтвердил её отправку.
```
const modal = new tingle.modal({
  beforeClose: function () {
    if (!isFormValid()) {
      alert('Форма не заполнена правильно!');
      return false;  // Отмена закрытия
    }
    return true;
  }
});
```
В этом примере проверяется, была ли форма заполнена правильно. Если форма невалидна, окно не закроется.

Важные особенности работы с `beforeClose`

Асинхронные действия: Параметр beforeClose может работать с асинхронными функциями. Это позволяет выполнять сложные проверки или взаимодействие с сервером перед закрытием модального окна.
Отмена закрытия: Возврат false из beforeClose отменяет закрытие окна, давая возможность выполнить дополнительные действия или предоставить пользователю выбор.
Прекращение выполнения: Если функция beforeClose не возвращает значения, модальное окно будет закрыто сразу после её выполнения, без каких-либо задержек.