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,getParentRoutevaaddChildrenmetodlari 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,beforeLoadvaType-Safetymexanizmlari bir xil mukammallikda ishlayveradi.