2nd/10_Wiki/Topics/Coding/React_Router_Patterns.md

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

id	title	category	status	source_trust_level	verification_status	created_at	updated_at	tags	tech_stack	applied_in	aliases
react-router-patterns	React Router — 데이터 로딩 통합 패턴	Coding	draft	B	conceptual	2026-05-09	2026-05-09	react routing data-loading vibe-coding	language applicable_to TypeScript / React Router 6+ / Next.js Web		loader action nested routes prefetch

React Router 데이터 로딩 통합

라우트 = URL 매칭만이 아니라 데이터 로딩 / 검증 / 권한 / 코드 분할의 단위. RR6 loader/action 또는 Next.js page/layout 모두 같은 철학 — "이 화면이 필요한 모든 것을 라우트가 선언".

📖 핵심 개념

• loader: 라우트 진입 시 병렬 fetch. 컴포넌트 렌더 전 완료.
• action: form POST 등 mutation. 완료 후 자동 revalidate.
• nested routes: 부모 layout 유지 + 자식 영역만 교체.
• prefetch on hover: 사용자가 클릭하기 전 다음 화면 데이터 미리.

💻 코드 패턴

// React Router 6 — data router
const router = createBrowserRouter([
  {
    path: '/users/:id',
    loader: async ({ params }) => {
      const [user, posts] = await Promise.all([
        fetchUser(params.id!),
        fetchPosts(params.id!),
      ]);
      return { user, posts };
    },
    action: async ({ request, params }) => {
      const data = Object.fromEntries(await request.formData());
      await updateUser(params.id!, data);
      return redirect(`/users/${params.id}`);
    },
    Component: UserPage,
    errorElement: <ErrorPage />,
  },
]);

function UserPage() {
  const { user, posts } = useLoaderData() as Awaited<ReturnType<typeof loader>>;
  return <Profile user={user} posts={posts} />;
}

// Prefetch on hover
<Link to="/users/1" prefetch="intent">User</Link>

🤔 의사결정 기준

화면	데이터 도구
정적 / 빌드 시 알려진	SSG (Next static)
사용자별 + SEO 필요	SSR (loader)
사용자별 + SEO 무관 (대시보드)	Client fetch (RR loader 도 OK)
Form 제출	action / Server Action
공유 layout	nested route + Outlet

❌ 안티패턴

• 컴포넌트 안 useEffect fetch + setState: waterfall + 깜빡임. loader 가 부모 + 자식 병렬.
• path param 검증 누락: /users/abc 도 통과. zod 검증 + 404.
• action 에서 직접 DB write 대신 API 호출: 한 번 더 hop. Server Action 또는 직접.
• pending UI 없음: 클릭 후 무반응. useNavigation().state === 'loading' 으로 표시.
• Link prefetch 모든 곳: 데이터/번들 폭증. 'intent' (hover) 가 균형.
• 에러 boundary 누락: 404/500 처리 없음. errorElement 또는 Next error.tsx.

🤖 LLM 활용 힌트

• 화면 1개 = 1 라우트 + loader + action + errorElement 4종 세트.
• prefetch='intent' 디폴트.

🔗 관련 문서

• React_Suspense_for_Data
• React_Error_Boundary