Модификация индикатора загрузки

Featherlight использует минималистичный индикатор загрузки, который отображается в момент ожидания контента (AJAX, изображения, iframe). По умолчанию это CSS-анимация, встроенная в стандартные стили библиотеки. Логика появления индикатора тесно связана с жизненным циклом модального окна и событиями инициализации контента.

Индикатор добавляется в DOM внутри контейнера .featherlight-content и управляется через CSS-класс .featherlight-loading. Пока контент не загружен, этот класс активен, а после успешной загрузки автоматически удаляется.

Структура HTML, связанная с загрузкой

При открытии модального окна Featherlight формирует следующую базовую структуру:

<div class="featherlight featherlight-loading">
  <div class="featherlight-content">
    <!-- контент или placeholder -->
  </div>
</div>

Ключевой момент — наличие класса featherlight-loading у корневого элемента. Именно он используется для отображения индикатора загрузки через CSS. Удаление класса происходит после события afterContent.

Стандартная CSS-реализация

В стандартном CSS Featherlight индикатор реализован через псевдоэлемент:

.featherlight-loading .featherlight-content:before {
  content: '';
  display: block;
  width: 30px;
  height: 30px;
  border-radius: 50%;
  border: 3px solid #ccc;
  border-top-color: #333;
  animation: featherlight-spin 1s linear infinite;
}

Анимация задаётся через @keyframes featherlight-spin. Такой подход упрощает замену индикатора без вмешательства в JavaScript-код библиотеки.

Полная замена визуального индикатора

Наиболее безопасный и поддерживаемый способ модификации — переопределение CSS. Для замены стандартного спиннера достаточно отключить псевдоэлемент и внедрить собственный.

Пример отключения стандартного индикатора:

.featherlight-loading .featherlight-content:before {
  display: none;
}

После этого можно использовать фон, SVG или кастомную HTML-структуру.

Использование SVG-анимации

SVG-индикаторы предпочтительны благодаря чёткости и гибкой анимации:

.featherlight-loading .featherlight-content {
  background: url('/assets/loader.svg') center center no-repeat;
  min-height: 120px;
}

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

Добавление HTML-индикатора через события

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

Наиболее важные события:

  • beforeOpen
  • beforeContent
  • afterContent

Пример добавления собственного HTML-индикатора:

$.featherlight.defaults.beforeContent = function () {
  this.$content.html(
    '<div class="custom-loader"><span></span></div>'
  );
};

После загрузки контента индикатор автоматически исчезнет, так как Featherlight заменит содержимое контейнера.

Контроль индикатора при AJAX-загрузке

При использовании AJAX-контента Featherlight автоматически отслеживает завершение запроса. Однако в сложных сценариях может потребоваться ручное управление классом загрузки.

Пример ручного контроля:

$.featherlight({
  ajax: '/data/content.html',
  beforeOpen: function () {
    this.$instance.addClass('featherlight-loading');
  },
  afterContent: function () {
    this.$instance.removeClass('featherlight-loading');
  }
});

Такой подход полезен при нестандартных источниках данных или дополнительной обработке контента.

Анимация появления и исчезновения индикатора

Для более плавного UX индикатор можно анимировать через CSS-переходы:

.featherlight-loading .custom-loader {
  opacity: 1;
  transition: opacity 0.3s ease;
}

.featherlight:not(.featherlight-loading) .custom-loader {
  opacity: 0;
  pointer-events: none;
}

Это исключает резкие визуальные скачки при быстрой загрузке контента.

Контекстная замена индикатора

Featherlight поддерживает индивидуальные настройки для каждого вызова. Это позволяет использовать разные индикаторы в зависимости от типа контента.

Пример передачи кастомного класса:

$.featherlight('/image.jpg', {
  className: 'image-loader'
});

CSS-реализация:

.featherlight.image-loader.featherlight-loading .featherlight-content {
  background: url('/assets/image-loader.svg') center no-repeat;
}

Отключение индикатора полностью

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

.featherlight-loading .featherlight-content {
  background: none;
}

.featherlight-loading .featherlight-content:before {
  content: none;
}

При этом логика ожидания загрузки сохраняется, но без визуального отображения.

Синхронизация с внешними прелоадерами

Featherlight не ограничивает использование сторонних индикаторов. Внешний прелоадер можно синхронизировать через события:

$(document).on('featherlight:beforeOpen', function () {
  showGlobalLoader();
});

$(document).on('featherlight:afterContent', function () {
  hideGlobalLoader();
});

Такой подход часто применяется в SPA-архитектурах и при интеграции с фреймворками интерфейса.

Особенности адаптивности и доступности

При кастомизации индикатора важно учитывать:

  • масштабирование на мобильных устройствах;
  • достаточный контраст;
  • отсутствие блокировки клавиатурной навигации.

Индикатор не должен перехватывать фокус и мешать закрытию модального окна.

Итоговая архитектура модификации

Модификация индикатора загрузки в Featherlight строится на трёх уровнях:

  • CSS-переопределения — основной и рекомендуемый способ;
  • HTML-вставки через события — для сложных сценариев;
  • JavaScript-контроль классов — при нестандартных источниках данных.

Такое разделение позволяет гибко управлять поведением и внешним видом индикатора без изменения исходного кода библиотеки.

Оглавление