Data Router: loader, action и ленивые маршруты
На этой странице
Data mode React Router (v6.4+, v7) объединяет маршрутизацию и данные: маршруты описываются конфигом в createBrowserRouter, у маршрута есть loader (загрузка данных до рендера, параллельно для всех вложенных маршрутов), action (обработка отправки <Form> и мутаций), errorElement/ErrorBoundary (ошибки загрузки и рендера) и lazy (код маршрута загружается параллельно с данными). После action React Router автоматически перевыполняет loaders — данные на экране обновляются без ручной синхронизации. Это устраняет главные проблемы подхода «fetch в useEffect»: водопады запросов, ручные флаги загрузки, гонки и рассинхронизацию после мутаций. Состояние навигации даёт useNavigation, неблокирующие мутации — useFetcher. Framework mode (бывший Remix) добавляет к этому SSR, prerender и типизацию.
Вопрос
Что такое loaders и actions в React Router? Чем data router лучше загрузки данных в useEffect?
Сравнение подходов
Declarative + useEffect:
клик → смена URL → рендер страницы → useEffect → fetch → рендер дочернего → его fetch ...
(водопад, спиннеры на каждом уровне)
Data Router:
клик → React Router параллельно запускает: код маршрута (lazy) + loaders всех вложенных маршрутов
→ когда готово — рендер готовых данныхКонфигурация
// main.tsx
import { createBrowserRouter, RouterProvider } from 'react-router';
import { createRoot } from 'react-dom/client';
import Root from './routes/root';
import ErrorPage from './routes/error-page';
const router = createBrowserRouter([
{
path: '/',
Component: Root,
ErrorBoundary: ErrorPage,
children: [
{ index: true, lazy: () => import('./routes/home') },
{
path: 'books',
lazy: () => import('./routes/books'), // экспортирует loader и Component
children: [
{ path: ':bookId', lazy: () => import('./routes/book') },
],
},
],
},
]);
createRoot(document.getElementById('root')!).render(<RouterProvider router={router} />);loader: данные до рендера
// routes/book.tsx
import { useLoaderData, data, type LoaderFunctionArgs } from 'react-router';
export async function loader({ params, request }: LoaderFunctionArgs) {
const res = await fetch(`/api/books/${params.bookId}`, { signal: request.signal }); // отмена при уходе
if (res.status === 404) throw data('Книга не найдена', { status: 404 });
return res.json() as Promise<Book>;
}
export function Component() {
const book = useLoaderData<typeof loader>();
return (
<article>
<h1>{book.title}</h1>
<p>{book.description}</p>
</article>
);
}request.signalотменяет запрос, если пользователь ушёл на другую страницу, — гонок нет.- Брошенный
data(..., { status })или ошибка попадает в ближайшийErrorBoundary. - Loaders вложенных маршрутов (
booksи:bookId) выполняются параллельно.
action: мутации через Form
// routes/book.tsx (продолжение)
import { Form, redirect, useNavigation, type ActionFunctionArgs } from 'react-router';
export async function action({ request, params }: ActionFunctionArgs) {
const formData = await request.formData();
const rating = Number(formData.get('rating'));
if (rating < 1 || rating > 5) return { error: 'Оценка от 1 до 5' };
await fetch(`/api/books/${params.bookId}/rating`, {
method: 'POST',
body: JSON.stringify({ rating }),
headers: { 'Content-Type': 'application/json' },
});
return redirect(`/books/${params.bookId}`); // после action loaders перевыполнятся
}
function RatingForm() {
const navigation = useNavigation();
const busy = navigation.state === 'submitting';
return (
<Form method="post">
<label>Оценка <input name="rating" type="number" min={1} max={5} /></label>
<button disabled={busy}>{busy ? 'Сохраняем…' : 'Оценить'}</button>
</Form>
);
}<Form> работает как HTML-форма, но без перезагрузки: React Router вызывает action, затем обновляет данные всех активных маршрутов. Результат action (ошибки валидации) читается через useActionData().
useFetcher: мутации без навигации
function FavoriteButton({ book }: { book: Book }) {
const fetcher = useFetcher();
const isFavorite = fetcher.formData ? fetcher.formData.get('favorite') === 'true' : book.favorite; // оптимистично
return (
<fetcher.Form method="post" action={`/books/${book.id}/favorite`}>
<button name="favorite" value={String(!isFavorite)} aria-pressed={isFavorite}>
{isFavorite ? '★' : '☆'}
</button>
</fetcher.Form>
);
}Подходит для лайков, избранного, отметок в списке — URL не меняется, несколько fetcher-ов работают параллельно.
Глобальный индикатор и ошибки
export default function Root() {
const navigation = useNavigation();
return (
<>
{navigation.state === 'loading' && <div className="progress-bar" role="progressbar" aria-label="Загрузка страницы" />}
<Outlet />
</>
);
}
export function ErrorPage() {
const error = useRouteError();
if (isRouteErrorResponse(error)) return <h1>{error.status}: {error.data}</h1>;
return <h1>Что-то пошло не так</h1>;
}Режимы React Router 7
| Режим | Что есть | Когда |
|---|---|---|
| Declarative | <BrowserRouter>, <Routes>, <Route> | Простое SPA, миграция со старых версий |
| Data | createBrowserRouter, loaders, actions, fetchers, lazy | SPA с серьёзной работой с данными |
| Framework | Vite-плагин, файловые маршруты, SSR/prerender, типы Route.* | Полноценное приложение, SEO, альтернатива Next.js |
Связка с TanStack Query
export const loader = (queryClient: QueryClient) => async ({ params }: LoaderFunctionArgs) =>
queryClient.ensureQueryData(bookQuery(params.bookId!)); // берёт из кэша или загружает
function Component() {
const { bookId } = useParams();
const { data: book } = useSuspenseQuery(bookQuery(bookId!)); // тот же ключ — данные уже есть
}Loader начинает загрузку как можно раньше, а TanStack Query отвечает за кэш, фоновое обновление и инвалидацию.
Что важно помнить
- Loader не заменяет кэш: без библиотеки данные загружаются при каждом переходе.
lazy+ loader = код и данные параллельно, без водопада.- После action данные обновляются автоматически — не нужно вручную «перезапрашивать».
- Проверка прав в loader на клиенте — удобство UX, а не защита: API должен проверять доступ сам.
Мини-шпаргалка
createBrowserRouter([...]) + <RouterProvider>
loader → данные до рендера, параллельно, request.signal
action + <Form> → мутация → автоперезагрузка loaders
useLoaderData, useActionData, useNavigation, useFetcher
ErrorBoundary + useRouteError + isRouteErrorResponse
lazy → код маршрута параллельно с данными