Routes directory — Route fayllarining strukturasi
TanStack Router'da src/routes papka strukturasi: real loyiha arxitekturasi, index.tsx, dinamik parametrlar ($), papkalar orqali guruhlash va nested layoutlar.
12-dars
Routes directory — Route fayllarining strukturasi
Tasavvur qiling, siz ko‘p tarmoqli yirik universitet kampusini loyihalashtiryapsiz. Kampusda barcha talabalar uchun umumiy asosiy darvoza va xiyobon mavjud (Root). Undan so‘ng alohida fakultet binolari keladi: Axborot texnologiyalari fakulteti (Dashboard), Iqtisodiyot fakulteti (Finance) va Kutubxona (Posts). Har bir fakultet binosi ichida dekanat (index), auditoriyalar va talabalarning shaxsiy laboratoriya xonalari ($userId) joylashgan.
Real veb-loyihalarda ham src/routes papkasi shunchaki bir nechta sahifadan iborat bo‘lmaydi. U o‘z ichiga autentifikatsiya, boshqaruv paneli (dashboard), ichma-ich joylashgan sahifalar, dinamik parametrlar va umumiy layoutlarni tartibli qamrab oladi.
1. Real loyihaning src/routes/ strukturasi misoli
Quyida o‘rta va yirik miqyosdagi zamonaviy IT loyihasining src/routes papka tuzilishi va ularning brauzerdagi URL manzillari keltirilgan:
src/
└── routes/
├── __root.tsx -> 1. Barcha sahifalar uchun umumiy ildiz (Root Layout)
├── index.tsx -> 2. Asosiy sahifa ("/")
├── login.tsx -> 3. Tizimga kirish sahifasi ("/login")
├── about.tsx -> 4. Biz haqimizda ("/about")
│
├── dashboard/ -> 5. Dashboard bo'limi papkasi
│ ├── index.tsx -> "/dashboard" (Dashboard bosh sahifasi)
│ ├── analytics.tsx -> "/dashboard/analytics" (Analitika)
│ └── users/ -> 6. Foydalanuvchilar bo'limi
│ ├── index.tsx -> "/dashboard/users" (Foydalanuvchilar ro'yxati)
│ └── $userId.tsx -> "/dashboard/users/:userId" (Dinamik profil)
│
└── posts/ -> 7. Postlar bo'limi
├── index.tsx -> "/posts" (Barcha maqolalar)
└── $postId.tsx -> "/posts/:postId" (Bitta maqola tafsiloti)
2. Strukturadagi asosiy maxsus belgilar va qoidalar
TanStack Router papka va fayllar nomlanishida juda aniq va qat'iy konvensiyalarga tayanadi:
1. index.tsx fayli (Default / Asosiy sahifa)
Agar papka ichida index.tsx fayli bo‘lsa, u o‘sha papka manzilining asosiy kirish sahifasi hisoblanadi:
src/routes/index.tsx$\to$/(Butun ilovaning bosh sahifasi)src/routes/dashboard/index.tsx$\to$/dashboard(Dashboard bo‘limining ilk sahifasi)src/routes/dashboard/users/index.tsx$\to$/dashboard/users(Foydalanuvchilar ro‘yxati)
2. Dinamik parametrlar ($ belgisi)
Fayl yoki papka nomi $ belgisi bilan boshlansa, bu dinamik parametr (Dynamic Route) degani. U React Router’dagi : belgisining o‘rnini bosadi:
posts/$postId.tsx$\to$/posts/105yoki/posts/salom-dunyousers/$userId.tsx$\to$/users/42
Komponent ichida bu parametr Route.useParams() orqali olinadi va u to‘liq type-safe (TypeScript avtomatik string deb biladi):
// src/routes/dashboard/users/$userId.tsx
import { createFileRoute } from '@tanstack/react-router'
export const Route = createFileRoute('/dashboard/users/$userId')({
component: UserProfilePage,
})
function UserProfilePage() {
// params: { userId: string } - 100% type-safe!
const { userId } = Route.useParams()
return (
<div>
<h2>Foydalanuvchi profili: ID #{userId}</h2>
</div>
)
}
3. Papka orqali ierarxiya tuzish (Folder Hierarchy)
Har bir ochilgan papka URL yo‘liga o‘z nomini qo‘shib boradi:
src/routes/dashboard/users/index.tsx $\to$ /dashboard/users.
[!NOTE] Agar siz shunchaki fayllarni papkalarga ajratib, lekin URL manzilga papka nomini qo‘shishni istamasangiz, TanStack Router’da Pathless Routes (masalan,
_auth/login.tsx$\to$/login) ishlatiladi. Bu haqida keyingi darslarda batafsil to‘xtalamiz.
3. Nested (Ichma-ich) layoutlar qanday ishlaydi?
Dashboard kabi katta bo‘limlarda barcha ichki sahifalar uchun bitta umumiy yon menyu (Sidebar) va tepa panel (Navbar) kerak bo‘ladi.
Buni amalga oshirish uchun dashboard/ papkasi bilan bir qatorda dashboard.tsx nomli alohida layout fayli yaratiladi:
src/routes/
├── dashboard.tsx -> Dashboard'ning umumiy LAYOUT fayli (<Outlet /> bilan)
└── dashboard/ -> Dashboard ichidagi barcha sahifalar
├── index.tsx -> "/dashboard"
└── analytics.tsx -> "/dashboard/analytics"
Kodda ko‘rinishi:
// src/routes/dashboard.tsx
import { createFileRoute, Outlet, Link } from '@tanstack/react-router'
export const Route = createFileRoute('/dashboard')({
component: DashboardLayout,
})
function DashboardLayout() {
return (
<div style={{ display: 'flex' }}>
{/* Doimiy umumiy yon menyu */}
<aside style={{ width: '250px', background: '#f4f4f4', padding: '1rem' }}>
<h3>Dashboard Menyu</h3>
<nav>
<Link to="/dashboard">Bosh sahifa</Link><br />
<Link to="/dashboard/analytics">Analitika</Link><br />
<Link to="/dashboard/users">Foydalanuvchilar</Link>
</nav>
</aside>
{/* Ichki sahifalar (index, analytics, users) aynan shu yerda almashadi */}
<main style={{ flex: 1, padding: '1.5rem' }}>
<Outlet />
</main>
</div>
)
}
graph TD
Root["__root.tsx (Sayt umumiy Header/Footer)"]
Root --> Outlet1["<Outlet />"]
Outlet1 --> DashLayout["dashboard.tsx (Sidebar + Panel)"]
DashLayout --> Outlet2["<Outlet /> (Dashboard ichki kontenti)"]
Outlet2 --> Analytics["dashboard/analytics.tsx"]
Outlet2 --> Users["dashboard/users/index.tsx"]
4. React Router vs TanStack Router (Struktura boshqaruvi)
| Xususiyat | React Router | TanStack Router (src/routes) |
|---|---|---|
| Ierarxiya e'lon qilinishi | Bitta ulkan routes massivida qo‘lda yoziladi |
Papka va fayl tizimining o‘zi avtomatik ierarxiya |
| Dinamik parametr belgisi | :userId |
$userId (operatsion tizimlar bilan 100% mos) |
| Loyihani tushunish | Router faylidagi yuzlab obyektlarni titkilash kerak | Papkaga bir qarashda butun sayt xaritasi tushunarli |
| Yangi ichki sahifa qo‘shish | Fayl ochib, massivning tegishli qismiga ehtiyotkorlik bilan ulash | Shunchaki dashboard/ ichiga yangi fayl tashlash yetarli |
Xulosa
src/routespapkasi butun loyihangizning arxitektura xaritasi vazifasini bajaradi.- Har bir papka URL qismini, undagi
index.tsxesa bo‘limning bosh sahifasini bildiradi. - O‘zgaruvchi parametrlar uchun fayl boshiga
$belgisi qo‘yiladi ($userId.tsx). - Ota layout fayli (masalan
dashboard.tsx) o‘zining<Outlet />i orqali o‘z nomi bilan ochilgan papka (dashboard/) ichidagi barcha sahifalarni o‘z ichiga oladi.