Series: TanStack Router Lesson 4

File-based vs Code-based routing — Ikki yondashuvning farqi va tanlash mezonlari

TanStack Router'da File-based va Code-based routing yondashuvlari: fayl strukturasi, createFileRoute, createRoute, avtomatik routeTree.gen.ts va loyiha hajmiga qarab tanlash mezonlari.

4-dars

File-based vs Code-based routing — Ikki yondashuvning farqi va tanlash mezonlari

Tasavvur qiling, siz yangi uy quryapsiz:

  1. File-based yondashuv (Tayyor arxitektura loyihasi): Quruvchilar loyiha chizmasi bo‘yicha har bir xonani aniq belgilangan joyga qurishadi: oshxona, yotoqxona va mehmonxona o‘z o‘rnida bo‘ladi (routes/kitchen.tsx, routes/bedroom.tsx). Xonalarning eshiklari va koridorlari avtomatik ravishda bir-biriga to‘g‘ri ulanadi.
  2. Code-based yondashuv (Erkin gipsokarton devorlar): Sizga bo‘m-bo‘sh katta maydon beriladi. Siz qayerga devor qo‘yishni, eshik qayerdan ochilishini va koridor qayerga borishini o‘z qo‘lingiz bilan santimetrigacha o‘lchab, kod orqali bittalab ulab chiqasiz.

TanStack Router’ning eng ajoyib jihatlaridan biri shundaki, u sizni bitta qolipga majburlab tiqib qo‘ymaydi. Loyihangiz arxitekturasidan kelib chiqqan holda xoh File-based (fayl strukturasi orqali avtomatik), xoh Code-based (kod orqali qo‘lda) yondashuvni tanlashingiz mumkin.


Ikkala yondashuv qanday ishlaydi?

flowchart TD
    subgraph FileBased["1. File-based Routing (Tavsiya etiladi)"]
        A["src/routes/ papkasi tuziladi"] --> B["Vite plagini fayllarni kuzatib turadi"]
        B --> C["routeTree.gen.ts avtomatik generatsiya bo'ladi"]
        C --> D["createFileRoute('/path') orqali ulanadi"]
    end

    subgraph CodeBased["2. Code-based Routing (Klassik usul)"]
        E["createRootRoute() yaratiladi"] --> F["createRoute({ path: '...' }) qo'lda yoziladi"]
        F --> G["rootRoute.addChildren([...]) bilan daraxt yig'iladi"]
        G --> H["Plagin shart emas, sof TypeScript kodi"]
    end

1. File-based Routing (Faylga asoslangan yondashuv)

Zamonaviy Next.js, Remix yoki Astro kabi, TanStack Router ham papka va fayllar strukturasi asosida avtomatik URL marshrutlarini hosil qila oladi.

Qanday ishlaydi?

Loyiha ishga tushganda yoki yangi fayl saqlanganda, @tanstack/router-plugin/vite plagini src/routes/ papkasini tahlil qiladi va fon rejimida routeTree.gen.ts faylini avtomatik yaratib, yangilab boradi.

Fayllar strukturasi misoli:

src/
├── routes/
│   ├── __root.tsx              # Asosiy ildiz layout (HTML / Navbar)
│   ├── index.tsx               # "/" (Bosh sahifa)
│   ├── about.tsx               # "/about" (Biz haqimizda)
│   ├── candidates/
│   │   ├── index.tsx           # "/candidates" (Nomzodlar ro'yxati)
│   │   └── $candidateId.tsx    # "/candidates/:candidateId" (Dinamik parametr)
│   └── dashboard.tsx           # "/dashboard" (Ichma-ich layout)

Fayl ichida kod qanday yoziladi? (about.tsx):

File-based rejimda marshrut createFileRoute funksiyasi yordamida e'lon qilinadi:

// src/routes/about.tsx
import { createFileRoute } from "@tanstack/react-router";

// Fayl yo'li avtomatik tarzda type-safe qilib bog'lanadi
export const Route = createFileRoute("/about")({
  component: AboutComponent,
});

function AboutComponent() {
  return (
    <div style={{ padding: "20px" }}>
      <h1>Biz haqimizda sahifasi</h1>
      <p>TanStack Router File-based rejimida ishlamoqda!</p>
    </div>
  );
}

2. Code-based Routing (Kodga asoslangan yondashuv)

Agar sizga hech qanday avtomatik fayl skanerlari yoki qo‘shimcha plaginlar kerak bo‘lmasa, barcha marshrutlarni xuddi React Router kabi to‘liq o‘z qo‘lingiz bilan sof kodda tuzib chiqishingiz mumkin.

Code-based kod misoli:

// src/router.tsx
import { 
  createRootRoute, 
  createRoute, 
  createRouter, 
  RouterProvider 
} from "@tanstack/react-router";

// 1. Ildiz marshrut (Root Route)
const rootRoute = createRootRoute({
  component: RootComponent,
});

// 2. Bosh sahifa
const indexRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: "/",
  component: HomeComponent,
});

// 3. Biz haqimizda sahifasi
const aboutRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: "/about",
  component: AboutComponent,
});

// 4. Dinamik parametrli nomzod sahifasi
const candidateDetailRoute = createRoute({
  getParentRoute: () => rootRoute,
  path: "/candidates/$candidateId",
  component: CandidateDetailComponent,
});

// 5. Daraxtni qo'lda yig'amiz
const routeTree = rootRoute.addChildren([
  indexRoute, 
  aboutRoute, 
  candidateDetailRoute
]);

// 6. Routerni yaratamiz
export const router = createRouter({ routeTree });

// Global tiplashtirish
declare module "@tanstack/react-router" {
  interface Register {
    router: typeof router;
  }
}

Qaysi birini tanlash kerak? (Taqqoslash jadvali)

Mezon File-based Routing Code-based Routing
Tavsiya etilishi TanStack jamoasi tomonidan rasmiy tavsiya (Standart) Maxsus holatlar yoki kichik modullar uchun
Katta loyihalar / Jamoaviy ish Juda qulay. Har bir sahifa o‘z faylida, tartibli va adashmaydi Katta loyihada bitta ulkan fayl yoki kaskadli ulanishlar chalkashishi mumkin
Plagin talabi Vite yoki Webpack plagini talab qilinadi Hech qanday plagin shart emas, sof TypeScript
Dinamik marshrutlar (Runtime) Papka konvensiyasi ($id.tsx) orqali belgilanadi Serverdan kelgan ma'lumotga qarab kodda dinamik route qo‘shish mumkin
React Router'dan o'tish Yangi fayl nomlash qoidalarini o‘rganish kerak Oson o‘tish. Mantiq React Router'ga juda o‘xshash
Fayl navigatsiyasi (IDE) Fayl nomiga qarab darhol sahifani topish oson Komponent qayerda ro‘yxatga olinganini qidirishga to‘g‘ri keladi

Qachon qaysi birini tanlash kerak?

File-based routingni tanlang, agar:

  • Yangi zamonaviy veb-ilova (SPA yoki SSR) boshlayotgan bo‘lsangiz;
  • Sahifalar soni 10 tadan ko‘p bo‘lsa va jamoada bir nechta dasturchi ishlasa;
  • Next.js yoki Remix kabi faylga asoslangan tartib va qulaylikni yoqtirsangiz.

Code-based routingni tanlang, agar:

  • Kichik widget, ichki SPA yoki Micro-frontend qurayotgan bo‘lsangiz;
  • Qurilmangizda yoki loyihangizda qo‘shimcha kod generatsiya qiluvchi plaginlarni ishlatish imkoni bo‘lmasa;
  • Marshrutlar ro‘yxati foydalanuvchining roli yoki tashqi server javobiga qarab dasturiy ravishda dinamik yig‘ilishi kerak bo‘lsa.

Xulosa

  • TanStack Router dasturchiga to‘liq erkinlik beradi: xohlasangiz avtomatik File-based, xohlasangiz qat'iy nazorat ostidagi Code-based arxitektura.
  • File-based yondashuv zamonaviy veb-dasturlashda vaqtni sezilarli darajada tejaydi va loyiha kengayganda tartibni saqlab qoladi.
  • Ikkala holatda ham TanStack Router o‘zining mashhur 100% End-to-End Type Safety va qat'iy turlar xavfsizligini to‘liq ta'minlab beradi.