Индикатор загрузки
На этой странице
Индикатор загрузки сообщает, что операция идёт, но это только одно из четырёх состояний экрана с данными: загрузка, успех с данными, успех без данных (пусто) и ошибка. Частая ошибка — правило «нет массива → спиннер»: тогда пустой ответ и упавший сервер выглядят как вечная загрузка. Правильно — явное поле статуса ("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 Query | isPending (данных ещё нет), isFetching (идёт запрос, в том числе фоновый), isError, placeholderData |
| SWR | isLoading (первая загрузка), isValidating (любая загрузка) |
| Suspense | fallback для первой загрузки; useTransition / useDeferredValue сохраняют старый экран при обновлении |
| Next.js App Router | loading.tsx — скелетон маршрута, стриминг частей через <Suspense> |
Что важно помнить
- Одно поле
statusвместо набора флагов — невозможные комбинации исчезают. - Пустой результат — это успех, а не загрузка.
- При фоновом обновлении не убирай уже показанные данные.
- Скелетон — того же размера, с
role="status"и без лишней анимации. - Не показывай индикатор для очень быстрых ответов.
Мини-шпаргалка
- loading → скелетон; error → сообщение + повтор; success + [] → «пусто»; success → данные.
- Первая загрузка ≠ фоновое обновление (
isPendingvsisFetching). aria-busy,role="status", без сдвигов макета.- Задержка показа спиннера ~300 мс.