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. <Outlet /> (Barcha bola sahifalar shu yerda almashadi)"]
Root --> Context["3. Global Context (Auth, Theme, QueryClient)"]
Root --> DevTools["4. <TanStackRouterDevtools />"]
Outlet --> Home["/ (Bosh sahifa)"]
Outlet --> About["/about (Haqida)"]
Outlet --> Candidates["/candidates (Nomzodlar)"]
Uning 4 ta asosiy vazifasi:
- Global Layout: Barcha sahifalar uchun umumiy bo‘lgan vizual elementlarni (Header, Navbar, Footer, Sidebar) ushlab turadi.
<Outlet />darchasi: Foydalanuvchi qaysi sahifaga o‘tsa, o‘sha bola sahifa aynan shu<Outlet />komponenti turgan joyda render bo‘ladi.- Global Context turlarini belgilash: Butun ilovaga tarqatiladigan kontekst (masalan: foydalanuvchi ma'lumotlari, autentifikatsiya holati) turlarini shu yerda mustahkamlab beradi.
- 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" }}>
© 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(yokicreateRootRouteWithContext) TanStack Router ilovangizning eng asosiy poydevori bo‘lib, butun sahifalarni yagona boshqaruvga birlashtiradi.- File-based rejimida u har doim
src/routes/__root.tsxfaylida 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.