TanStack Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash
TanStack Router'ni Vite + React + TypeScript loyihasiga o'rnatish: paketlar, Vite plagini, src/routes/ papkasi, __root.tsx, routeTree.gen.ts va DevTools integratsiyasi.
5-dars
TanStack Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash
Tasavvur qiling, siz yangi zamonaviy poyga avtomobilining barcha qismlarini (Vite + React + TypeScript) garajingizga keltirdingiz. Endi unga eng so‘nggi rusumdagi aqlli kompyuter boshqaruv tizimini (TanStack Router) o‘rnatib, barcha datchiklarini (DevTools, Vite Plugin) markaziy panelga ulashimiz kerak.
TanStack Router bilan ishlashni boshlash uchun bor-yo‘g‘i 4 ta aniq qadamni bosib o‘tamiz.
O'rnatish va Ishga tushirish zanjiri
flowchart TD
A["1. Paketlarni o'rnatish (npm / pnpm / yarn)"] --> B["2. vite.config.ts ga TanStackRouterVite plaginini ulash"]
B --> C["3. src/routes/__root.tsx va index.tsx yaratish"]
C --> D["4. npm run dev ishga tushishi bilan routeTree.gen.ts avtomatik paydo bo'ladi"]
D --> E["5. main.tsx ga RouterProvider ulash"]
1-qadam: Kerakli paketlarni o'rnatish
Terminalni ochib, quyidagi paketlarni o‘rnatamiz:
# Asosiy kutubxona
npm install @tanstack/react-router
# Dasturchi vositalari va Vite plagini (Dev dependencies)
npm install -D @tanstack/router-devtools @tanstack/router-plugin
Har bir paketning vazifasi:
@tanstack/react-router: Marshrutlash, havolalar, loader va hooklarni o‘z ichiga olgan asosiy yadro kutubxona.@tanstack/router-devtools: Brauzer burchagida marshrutlar, search parametrlar va kesh holatini ko‘rsatib turuvchi qulay vizual panel.@tanstack/router-plugin(yoki@tanstack/router-vite-plugin): Fayl strukturangizni kuzatib, avtomatik ravishdarouteTree.gen.tsfaylini generatsiya qilib turuvchi Vite plagini.
2-qadam: Vite plaginini ulash (vite.config.ts)
Vite o‘z-o‘zidan TanStack Router fayllarini skaner qila olmaydi. Shuning uchun unga maxsus plaginni kiritib qo‘yamiz:
// vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import { TanStackRouterVite } from "@tanstack/router-plugin/vite";
export default defineConfig({
plugins: [
// DIQQAT: TanStackRouterVite har doim react() plaginidan oldin turishi tavsiya etiladi!
TanStackRouterVite(),
react(),
],
});
3-qadam: Fayl tuzilmasini shakllantirish
File-based routing ishlashi uchun src/ papkasi ichida routes/ papkasini ochamiz va ikkita eng muhim boshlang‘ich faylni yaratamiz:
src/
├── routes/
│ ├── __root.tsx # Barcha sahifalar uchun ota Layout (Navbar, DevTools)
│ └── index.tsx # Bosh sahifa ("/")
└── main.tsx # Router butun React ilovasiga ulanadigan kirish nuqtasi
A) Asosiy ota qobiq: src/routes/__root.tsx
Bu fayl har bir ochiladigan sahifaning ustki qobig‘i hisoblanadi (masalan: doimiy Navbar, Footer va bolalar chiqadigan joy):
// src/routes/__root.tsx
import { createRootRoute, Link, Outlet } from "@tanstack/react-router";
import { TanStackRouterDevtools } from "@tanstack/router-devtools";
export const Route = createRootRoute({
component: RootComponent,
});
function RootComponent() {
return (
<>
{/* 1. Umumiy Navigatsiya paneli */}
<nav style={{ padding: "16px", borderBottom: "1px solid #e5e7eb", display: "flex", gap: "16px" }}>
<Link
to="/"
style={{ textDecoration: "none", color: "#2563eb", fontWeight: "bold" }}
activeProps={{ style: { textDecoration: "underline" } }}
>
Bosh sahifa
</Link>
</nav>
{/* 2. Bola sahifalar aynan shu yerda almashadi */}
<main style={{ padding: "20px" }}>
<Outlet />
</main>
{/* 3. Ishlab chiqish uchun qulay DevTools oynasi */}
<TanStackRouterDevtools position="bottom-right" />
</>
);
}
B) Bosh sahifa: src/routes/index.tsx
Bu "/" manziliga kirganda ko‘rinadigan bosh sahifadir:
// src/routes/index.tsx
import { createFileRoute } from "@tanstack/react-router";
export const Route = createFileRoute("/")({
component: HomeComponent,
});
function HomeComponent() {
return (
<div>
<h1>Xush kelibsiz! 🚀</h1>
<p>Bu TanStack Router bilan qurilgan bosh sahifa.</p>
</div>
);
}
4-qadam: Routerni ilovaga ulash (main.tsx)
Loyihangiz terminalida npm run dev buyrug‘ini berishingiz bilan, Vite plagini src/ ichida routeTree.gen.ts faylini avtomatik yaratib beradi.
Endi main.tsx faylini ochib, routerni ulaymiz:
// src/main.tsx
import React from "react";
import ReactDOM from "react-dom/client";
import { RouterProvider, createRouter } from "@tanstack/react-router";
// Plagin yaratib bergan tayyor daraxtni import qilamiz
import { routeTree } from "./routeTree.gen";
// 1. Router instansiyasini hosil qilamiz
const router = createRouter({ routeTree });
// 2. TypeScript uchun Routerni global ro'yxatdan o'tkazamiz
declare module "@tanstack/react-router" {
interface Register {
router: typeof router;
}
}
// 3. Ilovani render qilamiz
ReactDOM.createRoot(document.getElementById("root")!).render(
<React.StrictMode>
<RouterProvider router={router} />
</React.StrictMode>
);
5. DevTools bilan tanishuv
Loyihani brauzerda ochsangiz (http://localhost:5173), pastki o‘ng burchakda TanStack Router logotipi tushirilgan kichik tugmani ko‘rasiz:
┌────────────────────────────────────────────────────────┐
│ TanStack Router DevTools │
├────────────────────────────────────────────────────────┤
│ Active Routes: │
│ └── /__root │
│ └── / │
│ │
│ Search Params: {} │
│ Loader Data: None │
└────────────────────────────────────────────────────────┘
Bu panel orqali siz:
- Ayni paytda qaysi marshrutlar faol ekanligini;
- URL search parametrlari qanday parse qilinganini;
- Loader ma'lumotlari keshda qanday turganini bevosita ko‘rib turishingiz mumkin.
Muhim eslatmalar va Maslahatlar
[!WARNING]
routeTree.gen.tsfaylini qo‘lda tahrirlamang! Ushbu fayl boshida/* prettier-ignore-start */va/* eslint-disable */deb yozib qo‘yilgan. Sizsrc/routes/papkasiga yangi fayl qo‘shsangiz yoki o‘chirsangiz, plagin bu faylni o‘zi qaytadan yozib beradi.
[!TIP] Agar yangi fayl yaratganingizda VS Code xatolik ko‘rsatsa yoki
routeTree.gen.tsyangilanmay qolsa, shunchaki terminaldanpm run devishlab turganiga ishonch hosil qiling va faylni bir martaCtrl + Sbilan qayta saqlang.
Xulosa
- TanStack Router'ni Vite loyihasiga ulash atigi 4 ta qadamdan iborat: paketlarni o‘rnatish, Vite plaginini yoqish,
__root.tsxlayoutini tuzish vamain.tsxdaRouterProviderorqali ulab qo‘yish. TanStackRouterViteplagini fayllar strukturasi asosida avtomatik ravishda TypeScript marshrutlar daraxtini hosil qiladi.TanStackRouterDevtoolsesa dasturlash jarayonida marshrutlar va holatlarni real vaqtda kuzatib borishda eng yaxshi yordamchingizga aylanadi.