Seriya: TanStack Router Dars 7

Root route — createRootRoute va ilovaning asosiy route'i

TanStack Router'da createRootRoute va __root.tsx: global layout, <Outlet />, Router Context turlari, <Link activeProps> va TanStackRouterDevtools.

7-dars

Root route — createRootRoute va ilovaning asosiy route'i

Tasavvur qiling, siz ko‘p qavatli zamonaviy biznes-markaziga kirdingiz. Har qanday mehmon 10-qavatdagi IT bo‘limiga yoki 5-qavatdagi konferensiya zaliga chiqmoqchi bo‘lsa ham, avvalo binoning asosiy vestibyulidan (vestibule / qabulxona zali) o‘tishi shart. Bu yerda asosiy kirish eshigi, ma'lumotlar tablosi (Navbar), liftlar tizimi (<Outlet />) va xavfsizlik nazorati (Global Auth Context) joylashgan.

TanStack Router’da barcha marshrutlar xuddi ana shunday yagona va mustahkam poydevorga tayanadi. Bu poydevor Root Route (createRootRoute) deb ataladi.


createRootRoute nima va u nima uchun kerak?

createRootRoute — bu marshrutlar daraxtining (Route Tree) eng yuqorisida turuvchi va hech qanday URL yo‘liga (path) ega bo‘lmagan mutlaq ota (parent) routedir.

flowchart TD
    Root["__root.tsx (createRootRoute)"]
    Root --> Nav["1. Global Navbar & Header"]
    Root --> Outlet["2. &lt;Outlet /&gt; (Barcha bola sahifalar shu yerda almashadi)"]
    Root --> Context["3. Global Context (Auth, Theme, QueryClient)"]
    Root --> DevTools["4. &lt;TanStackRouterDevtools /&gt;"]

    Outlet --> Home["/ (Bosh sahifa)"]
    Outlet --> About["/about (Haqida)"]
    Outlet --> Candidates["/candidates (Nomzodlar)"]

Uning 4 ta asosiy vazifasi:

  1. Global Layout: Barcha sahifalar uchun umumiy bo‘lgan vizual elementlarni (Header, Navbar, Footer, Sidebar) ushlab turadi.
  2. <Outlet /> darchasi: Foydalanuvchi qaysi sahifaga o‘tsa, o‘sha bola sahifa aynan shu <Outlet /> komponenti turgan joyda render bo‘ladi.
  3. Global Context turlarini belgilash: Butun ilovaga tarqatiladigan kontekst (masalan: foydalanuvchi ma'lumotlari, autentifikatsiya holati) turlarini shu yerda mustahkamlab beradi.
  4. DevTools: Ishlab chiqish muhitida pastki burchakda turadigan qulay vizual vositani ulab turadi.

1. File-based konvensiyasi: src/routes/__root.tsx

File-based routing ishlatganda, bu fayl har doim src/routes/__root.tsx deb nomlanadi.

[!NOTE] Fayl nomining boshidagi ikkita pastki chiziq (__root) TanStack Router'ga ushbu fayl URL segmenti hosil qilmasligini, balki barcha sahifalar uchun umumiy poydevor ekanligini bildiradi.


2. To'liq amaliy kod: src/routes/__root.tsx

Keling, global kontekst turi, qulay navigatsiya havolalari (activeProps) va xatoliklar oynasi bilan to‘liq __root.tsx faylini quramiz:

// src/routes/__root.tsx
import { 
  createRootRouteWithContext, 
  Link, 
  Outlet 
} from "@tanstack/react-router";
import { TanStackRouterDevtools } from "@tanstack/router-devtools";

// 1. Router Context interfeysini e'lon qilamiz
export interface MyRouterContext {
  auth: {
    isAuthenticated: boolean;
    user: { id: string; name: string; role: string } | null;
  };
}

// 2. createRootRouteWithContext yordamida tiplashtirilgan Root Route yaratamiz
export const Route = createRootRouteWithContext<MyRouterContext>()({
  component: RootComponent,

  // Global xatolik yuz berganda chiqadigan oyna
  errorComponent: ({ error }) => (
    <div style={{ padding: "40px", textAlign: "center", color: "#ef4444" }}>
      <h2>Tizimda global nosozlik yuz berdi!</h2>
      <p>{error.message}</p>
    </div>
  ),

  // Global 404 sahifasi
  notFoundComponent: () => (
    <div style={{ padding: "40px", textAlign: "center" }}>
      <h2>404 — Sahifa topilmadi 🧭</h2>
      <Link to="/" style={{ color: "#2563eb" }}>Bosh sahifaga qaytish</Link>
    </div>
  ),
});

// 3. Root UI Komponenti
function RootComponent() {
  return (
    <div style={{ minHeight: "100vh", display: "flex", flexDirection: "column" }}>
      
      {/* A) UMUMIY HEADER VA NAVBAR */}
      <header
        style={{
          padding: "16px 24px",
          borderBottom: "1px solid #e5e7eb",
          display: "flex",
          justifyContent: "space-between",
          alignItems: "center",
          background: "#fff",
        }}
      >
        <div style={{ fontWeight: "bold", fontSize: "18px", color: "#111827" }}>
          HR Dashboard ⚡
        </div>

        <nav style={{ display: "flex", gap: "20px" }}>
          {/* Bosh sahifa */}
          <Link
            to="/"
            style={{ textDecoration: "none", color: "#4b5563" }}
            activeProps={{ style: { fontWeight: "bold", color: "#2563eb" } }}
          >
            Bosh sahifa
          </Link>

          {/* Nomzodlar ro'yxati */}
          <Link
            to="/candidates"
            style={{ textDecoration: "none", color: "#4b5563" }}
            activeProps={{ style: { fontWeight: "bold", color: "#2563eb" } }}
          >
            Nomzodlar
          </Link>

          {/* Biz haqimizda */}
          <Link
            to="/about"
            style={{ textDecoration: "none", color: "#4b5563" }}
            activeProps={{ style: { fontWeight: "bold", color: "#2563eb" } }}
          >
            Haqida
          </Link>
        </nav>
      </header>

      {/* B) BARCHA BOLA SAHIFALAR SHU YERDA CHIQADI */}
      <main style={{ flex: 1, padding: "24px" }}>
        <Outlet />
      </main>

      {/* C) UMUMIY FOOTER */}
      <footer style={{ padding: "16px", textAlign: "center", borderTop: "1px solid #e5e7eb", color: "#9ca3af", fontSize: "14px" }}>
        &copy; 2026 TanStack Router Loyihasi
      </footer>

      {/* D) ISHLAB CHIQISH DEVTOOLS OYNASI */}
      <TanStackRouterDevtools position="bottom-right" />
    </div>
  );
}

export default RootComponent;

3. <Link> va activeProps afzalligi

TanStack Router'dagi <Link> komponenti React Router'dagi kabi alohida <NavLink> tegini talab qilmaydi. Uning o‘zida activeProps xususiyati mavjud:

<Link
  to="/candidates"
  style={{ color: "#666" }}
  activeProps={{
    style: { fontWeight: "bold", color: "#2563eb" },
    className: "active-link",
  }}
>
  Nomzodlar
</Link>

Foydalanuvchi aynan shu sahifada turganda, TanStack Router avtomatik ravishda activeProps ichidagi stillarni havolaga qo‘shadi!


React Router va TanStack Router Root yondashuvi taqqosi

Xususiyat React Router (v6/v7) TanStack Router (__root.tsx)
Ildiz yo‘li nomi Maxsus nom yo‘q (Pathless route: path: "/") Aniq konvensiya: __root.tsx
Layout yaratish element: <Layout><Outlet /></Layout> createRootRoute / createRootRouteWithContext
Global Context uzatish Alohida React Context Provider kerak To‘g‘ridan-to‘g‘ri Router Context tizimi mavjud
Active Havolalar Alohida <NavLink> tegi kerak Oddiy <Link activeProps={...}> ning o‘zi yetarli
DevTools Rasmiy o‘rnatilgan vizual panel yo‘q <TanStackRouterDevtools /> o‘rnatilgan

Xulosa

  • createRootRoute (yoki createRootRouteWithContext) TanStack Router ilovangizning eng asosiy poydevori bo‘lib, butun sahifalarni yagona boshqaruvga birlashtiradi.
  • File-based rejimida u har doim src/routes/__root.tsx faylida joylashadi.
  • Uning ichida joylashgan <Outlet /> barcha bolalar sahifalarining render bo‘lish nuqtasi hisoblanadi.
  • Ushbu poydevor orqali global kontekst turlarini aniqlab, pastdagi barcha sahifalarga xavfsiz (type-safe) tarzda yetkazish mumkin.