Series: TanStack Router Lesson 65

Code-based routing — File-based routing'siz route tree yaratish

TanStack Router'da Code-Based routing: createRoute, getParentRoute, addChildren, mikro-frontendlar, dinamik marshrutlar va File-based routing bilan taqqos.

65-dars

Code-based routing — File-based routing'siz route tree yaratish

TanStack Router ko‘pincha fayllar tizimiga asoslangan (File-Based Routing) yo‘naltirish bilan mashhur bo‘lsa-da, uning poydevori dasturiy kod orqali marshrutlar daraxtini qurishga (Code-Based Routing) asoslangan.

Fayl generatorlarisiz (tsr generate), to‘g‘ridan-to‘g‘ri TypeScript kodida createRoute funksiyalari orqali marshrutlarni bir-biriga bog‘lash ba'zi maxsus arxitekturaviy vaziyatlarda tengsiz ustunlik beradi.


1. Hayotiy o‘xshatish: Modulli karkas va Qo‘lda g‘isht terish

Tasavvur qiling, siz bino quryapsiz:

  • File-Based Routing (Modulli / Prefabrik qurilish): Zavodda oldindan tayyorlangan xona bloklari (src/routes/ papkalari). Qurilish krani ularni fayl nomlariga qarab avtomatik ravishda bir-birining ustiga taxlab chiqadi. Juda tez, standartlashtirilgan va yirik loyihalar uchun qulay.
  • Code-Based Routing (Qo‘lda maxsus me'morchilik): Usta har bir g‘ishtni (createRoute) o‘z qo‘li bilan maxsus eritma (getParentRoute) yordamida o‘rnatadi. Har qanday noodatiy shakl, harakatlanuvchi devorlar yoki dinamik o‘zgaruvchi xonalar (Mikro-frontendlar) kerak bo‘lganda, bu usul to‘liq nazorat va erkinlik beradi.

2. Nima uchun va qachon Code-Based Routing kerak?

+-----------------------------------------------------------------------------------+
|                        CODE-BASED ROUTING ISHLATILADIGAN HOLATLAR                 |
+-----------------------------------------------------------------------------------+
| 1. Mikro-frontendlar (Micro-Frontends):                                           |
|    Turli jamoalar tomonidan alohida yozilgan modullarni yagona routerga dasturiy  |
|    ravishda birlashtirish kerak bo'lganda.                                        |
|                                                                                   |
| 2. Dinamik Marshrutlar (Dynamic Route Generation):                                |
|    Serverdan kelgan foydalanuvchi huquqlari yoki ma'lumotlar bazasi asosida       |
|    marshrutlar ro'yxatini runtime vaqtida shakllantirish talab etilganda.         |
|                                                                                   |
| 3. NPM Paketlar va Mustaqil Vidjetlar:                                            |
|    Fayl generatori yoki Vite pluginini ishlatish imkoni bo'lmagan mustaqil        |
|    React kutubxonalarini yaratishda.                                              |
+-----------------------------------------------------------------------------------+

3. Dasturiy Route Tree yaratish namunasi

Code-based routingda marshrutlar ota-bola munosabati (getParentRoute va addChildren) orqali qo‘lda birlashtiriladi:

// src/router.tsx
import { 
  createRootRoute, 
  createRoute, 
  createRouter, 
  Outlet, 
  Link 
} from '@tanstack/react-router'

// 1. Root (Ildiz) route yaratamiz
const rootRoute = createRootRoute({
  component: () => (
    <div className="app-layout">
      <nav className="navbar">
        <Link to="/">Bosh sahifa</Link>
        <Link to="/about">Biz haqimizda</Link>
        <Link to="/posts">Maqolalar</Link>
      </nav>
      <hr />
      {/* Barcha bola sahifalar shu yerda chiqadi */}
      <main>
        <Outlet />
      </main>
    </div>
  ),
})

// 2. Bosh sahifa (Index Route)
const indexRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/',
  component: () => <h2>Asosiy sahifaga xush kelibsiz!</h2>,
})

// 3. Statik sahifa
const aboutRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/about',
  component: () => <h2>Kompaniya haqida ma'lumot</h2>,
})

// 4. Dinamik segmentli marshrut (/posts/$postId)
const postsRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: '/posts',
  component: () => (
    <div>
      <h2>Maqolalar Bo‘limi</h2>
      <Outlet />
    </div>
  ),
})

const postDetailRoute = createRoute({
  getParentRoute: () => postsRoute, // Ota marshrut postsRoute bo'ladi!
  path: '$postId',
  loader: async ({ params }) => {
    return { id: params.postId, title: `Maqola #${params.postId}` }
  },
  component: PostDetailPage,
})

function PostDetailPage() {
  const post = postDetailRoute.useLoaderData()
  return <div>Maqola tafsilotlari: {post.title}</div>
}

// 5. Route Tree'ni tashkil qilish
const routeTree = rootRoute.addChildren([
  indexRoute,
  aboutRoute,
  postsRoute.addChildren([
    postDetailRoute, // postsRoute ichidagi bola marshrut
  ]),
])

// 6. Router instansiyasini hosil qilamiz
export const router = createRouter({ routeTree })

// TypeScript uchun router turini ro'yxatga olamiz
declare module '@tanstack/react-router' {
  interface Register {
    router: typeof router
  }
}

4. Code-Based Route Tree Ierarxiyasi (Mermaid Diagram)

flowchart TD
    Root["rootRoute (createRootRoute)"]
    
    Root --> Index["indexRoute (path: '/')"]
    Root --> About["aboutRoute (path: '/about')"]
    Root --> Posts["postsRoute (path: '/posts')"]

    subgraph Nested["postsRoute.addChildren()"]
        Posts --> PostDetail["postDetailRoute (path: '$postId')"]
    end

5. File-Based va Code-Based yondashuvlar taqqosi

Xususiyat File-Based Routing Code-Based Routing
Tashkil etilishi Fayllar va papkalar nomlari orqali (src/routes/) To‘g‘ridan-to‘g‘ri kod ichida (createRoute)
Generatorga talab tsr generate yoki Vite plugin talab etiladi Hech qanday generator kerak emas
Mos keladigan soha Ko‘pchilik standart SPA, SSR va katta loyihalar Mikro-frontendlar, vidjetlar, dinamik marshrutlar
Ichki imkoniyatlar loader, beforeLoad, validateSearch mavjud Bir xil darajada barcha kuchli imkoniyatlar mavjud
Qulaylik Fayl qo‘shish bilan marshrut tayyor bo‘ladi Har bir marshrutni ota-bolaga qo‘lda bog‘lash kerak

Xulosa

  • Code-Based Routing — marshrutlar daraxtini fayllar tizimiga bog‘lanmasdan, to‘liq dasturiy kod orqali yaratish usulidir.
  • U createRoute, getParentRoute va addChildren metodlari orqali ierarxik daraxt hosil qiladi.
  • Bu yondashuv mikro-frontend arxitekturalari, dinamik marshrut generatsiyasi va NPM kutubxonalari uchun ajralmas yechimdir.
  • TanStack Router'ning eng katta kuchi shundaki: uslubdan qat'i nazar, barcha loader, beforeLoad va Type-Safety mexanizmlari bir xil mukammallikda ishlayveradi.