Series: TanStack Router Lesson 12

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/105 yoki /posts/salom-dunyo
  • users/$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["&lt;Outlet /&gt;"]
    Outlet1 --> DashLayout["dashboard.tsx (Sidebar + Panel)"]
    DashLayout --> Outlet2["&lt;Outlet /&gt; (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/routes papkasi butun loyihangizning arxitektura xaritasi vazifasini bajaradi.
  • Har bir papka URL qismini, undagi index.tsx esa 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.