re:re:actable
Урок 045 минут чтения

Индикатор загрузки

На этой странице
Кратко

Индикатор загрузки сообщает, что операция идёт, но это только одно из четырёх состояний экрана с данными: загрузка, успех с данными, успех без данных (пусто) и ошибка. Частая ошибка — правило «нет массива → спиннер»: тогда пустой ответ и упавший сервер выглядят как вечная загрузка. Правильно — явное поле статуса ("loading" | "success" | "error"), а пустоту проверять внутри успеха. Важно различать первую загрузку (данных ещё нет → скелетон) и фоновое обновление (данные уже есть → оставить их и показать маленький индикатор, иначе экран мигает). Скелетон должен занимать то же место, что и контент (нет сдвигов макета), а для скринридеров — role="status" / aria-busy. Короткие загрузки (< 300 мс) лучше не показывать вовсе, чтобы не было вспышек.

Вопрос

Как правильно организовать состояния загрузки, успеха, пустого результата и ошибки?

Ошибка: «нет данных — значит грузится»

function Books({ books }) {
  if (!books.length) return <Spinner />; // ✗ пустая библиотека → вечный спиннер
  return <BookList books={books} />;
}
API вернул []           → пользователь видит спиннер навсегда
API вернул 500          → тоже спиннер, ошибка спрятана
Повторная загрузка      → список пропадает, экран мигает

Четыре состояния

              ┌──────────── success ────────────┐
loading ──────┤  data.length > 0 → список        │
   │          │  data.length = 0 → «Пока пусто»  │
   │          └──────────────────────────────────┘
   └────────── error → сообщение + «Повторить»

Пример: все состояния и фоновое обновление

import { useCallback, useEffect, useState } from "react";
 
export default function Library() {
  const [state, setState] = useState({ status: "loading", books: [], error: null });
  const [refreshing, setRefreshing] = useState(false);
 
  const load = useCallback(async (signal) => {
    const res = await fetch("/api/books", { signal });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    return res.json();
  }, []);
 
  // Первая загрузка
  useEffect(() => {
    const controller = new AbortController();
    load(controller.signal)
      .then((books) => setState({ status: "success", books, error: null }))
      .catch((error) => {
        if (error.name !== "AbortError") setState({ status: "error", books: [], error });
      });
    return () => controller.abort();
  }, [load]);
 
  // Фоновое обновление: данные остаются на экране
  async function refresh() {
    setRefreshing(true);
    try {
      const books = await load();
      setState({ status: "success", books, error: null });
    } catch {
      /* оставляем старые данные, можно показать тост */
    } finally {
      setRefreshing(false);
    }
  }
 
  if (state.status === "loading") return <BooksSkeleton />;
 
  if (state.status === "error") {
    return (
      <div role="alert">
        <p>Не удалось загрузить библиотеку.</p>
        <button onClick={() => window.location.reload()}>Повторить</button>
      </div>
    );
  }
 
  return (
    <section aria-busy={refreshing}>
      <header>
        <h2>Мои книги</h2>
        <button onClick={refresh} disabled={refreshing}>
          {refreshing ? "Обновляем…" : "Обновить"}
        </button>
      </header>
 
      {state.books.length === 0 ? (
        <p>Пока пусто. <a href="/catalog">Найти книгу</a></p>
      ) : (
        <ul>{state.books.map((b) => <li key={b.id}>{b.title}</li>)}</ul>
      )}
    </section>
  );
}

Скелетон без сдвигов

function BooksSkeleton() {
  return (
    <section>
      <p role="status" className="visually-hidden">Загружаем книги…</p>
      <ul aria-hidden="true">
        {Array.from({ length: 5 }, (_, i) => (
          <li key={i} className="skeleton" style={{ height: 24, marginBlock: 8 }} />
        ))}
      </ul>
    </section>
  );
}
.skeleton { background: linear-gradient(90deg, #eee, #f5f5f5, #eee); background-size: 200% 100%; animation: shimmer 1.2s infinite; border-radius: 6px; }
@keyframes shimmer { to { background-position: -200% 0; } }
@media (prefers-reduced-motion: reduce) { .skeleton { animation: none; } }
ПриёмЗачем
Скелетон той же высоты, что контентНет сдвигов макета (CLS)
aria-hidden на декоративных блоках + один role="status"Скринридер слышит «Загружаем книги», а не пустые блоки
aria-busy на контейнере при обновленииСообщает, что содержимое обновляется
Отключение анимации при prefers-reduced-motionДоступность

Не мигать на быстрых ответах

function useDelayedFlag(active, delay = 300) {
  const [show, setShow] = useState(false);
  useEffect(() => {
    if (!active) return setShow(false);
    const id = setTimeout(() => setShow(true), delay);
    return () => clearTimeout(id);
  }, [active, delay]);
  return show;
}
 
const showSpinner = useDelayedFlag(isFetching); // спиннер только если дольше 300 мс

Готовые решения

ИнструментКак выражаются состояния
TanStack QueryisPending (данных ещё нет), isFetching (идёт запрос, в том числе фоновый), isError, placeholderData
SWRisLoading (первая загрузка), isValidating (любая загрузка)
Suspensefallback для первой загрузки; useTransition / useDeferredValue сохраняют старый экран при обновлении
Next.js App Routerloading.tsx — скелетон маршрута, стриминг частей через <Suspense>

Что важно помнить

  • Одно поле status вместо набора флагов — невозможные комбинации исчезают.
  • Пустой результат — это успех, а не загрузка.
  • При фоновом обновлении не убирай уже показанные данные.
  • Скелетон — того же размера, с role="status" и без лишней анимации.
  • Не показывай индикатор для очень быстрых ответов.

Мини-шпаргалка

  • loading → скелетон; error → сообщение + повтор; success + [] → «пусто»; success → данные.
  • Первая загрузка ≠ фоновое обновление (isPending vs isFetching).
  • aria-busy, role="status", без сдвигов макета.
  • Задержка показа спиннера ~300 мс.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам