RouterProvider — Router'ni React ildiziga (root) ulash
TanStack Router'da RouterProvider: routerni React daraxtiga ulash, context prop orqali jonli ma'lumotlar uzatish va React Router bilan taqqoslash.
8-dars
RouterProvider — Router'ni React ildiziga (root) ulash
Tasavvur qiling, siz bino uchun eng so‘nggi rusumdagi kuchli elektr generatorini (barcha marshrutlar, qoidalar va xaritalarni o‘z ichiga olgan router instansiyasini) yig‘ib qo‘ydingiz. Lekin bu generatorni uyning asosiy elektr tarqatish qutisiga (elektr shchitiga) ulaguningizcha xonalarda chiroqlar yonmaydi, rozetkalar ishlamaydi.
TanStack Router’dagi RouterProvider — bu o‘sha tayyor generatorni (ya'ni createRouter orqali hosil qilingan router obyektini) butun React ilovasiga ulab, barcha sahifalarga navigatsiya "quvvatini" tarqatib beradigan asosiy markaziy kabeldir.
RouterProvider nima qiladi va qanday ishlaydi?
RouterProvider — bu React Context arxitekturasi asosida ishlaydigan maxsus konteyner komponent.
flowchart TD
Router["createRouter({ routeTree }) (Generator)"] --> Provider["<RouterProvider router={router} /> (Elektr shchiti)"]
Provider --> Tree["Butun React Komponentlar Daraxti"]
Tree --> Hook1["useNavigate() (Dasturiy navigatsiya)"]
Tree --> Hook2["useParams() (URL parametrlari)"]
Tree --> Hook3["useSearch() (Type-safe query parametrlar)"]
Tree --> Link["<Link to='...' /> (Avto-to'ldirish bilan)"]
Uning 3 ta asosiy vazifasi:
- URL o‘zgarishlarini kuzatish: Brauzerdagi manzil satri o‘zgarganda mos keluvchi sahifa komponentini topib, uni ekranga chizadi.
- Hooklar uchun muhit yaratish:
useNavigate,useParams,useSearchvauseLoaderDatakabi hooklarning to‘g‘ri ishlashini ta'minlaydi. - Pending va xatoliklar boshqaruvi: Sahifa yuklanayotganda
defaultPendingComponentni va kutilmagan nosozliklardadefaultErrorComponentni ekranga chiqaradi.
1. Asosiy ulanish: src/main.tsx
Odatda loyihaning eng asosiy kirish nuqtasi bo‘lgan main.tsx faylida router yaratiladi va RouterProvider orqali document.getElementById('root') ga ulanadi:
// src/main.tsx
import React from "react";
import ReactDOM from "react-dom/client";
import { RouterProvider, createRouter } from "@tanstack/react-router";
// 1. Avtomatik yaratilgan marshrutlar daraxtini chaqiramiz
import { routeTree } from "./routeTree.gen";
// 2. Router instansiyasini tuzamiz
const router = createRouter({
routeTree,
defaultPreload: "intent", // Hover qilganda ma'lumotni oldindan yuklash
});
// 3. TypeScript uchun global ro'yxatdan o'tkazish (Autocomplete ishlashi uchun SHART)
declare module "@tanstack/react-router" {
interface Register {
router: typeof router;
}
}
// 4. React ildiziga RouterProvider orqali ulaymiz
const rootElement = document.getElementById("root")!;
if (!rootElement.innerHTML) {
const root = ReactDOM.createRoot(rootElement);
root.render(
<React.StrictMode>
<RouterProvider router={router} />
</React.StrictMode>
);
}
2. Jonli kontekstni uzatish (context prop)
RouterProviderning eng qudratli imkoniyatlaridan biri — bu unga dinamik, jonli ma'lumotlarni (context) uzatishdir.
Tasavvur qiling, sizda foydalanuvchining login holatini saqlovchi React hook mavjud (useAuth()). Foydalanuvchi tizimga kirganida yoki chiqqanida, marshrutlar buni darhol bilishi va himoyalangan sahifalarga ruxsat berishi (yoki bloklashi) lozim:
// src/App.tsx
import { RouterProvider, createRouter } from "@tanstack/react-router";
import { routeTree } from "./routeTree.gen";
import { useAuth } from "./context/AuthContext";
// Router yaratamiz
const router = createRouter({
routeTree,
context: {
// Boshlang'ich bo'sh qiymat
auth: undefined!,
},
});
export function App() {
// Haqiqiy jonli autentifikatsiya holati
const auth = useAuth();
// RouterProvider'ga jonli context beramiz!
return <RouterProvider router={router} context={{ auth }} />;
}
[!TIP] Nima uchun bu ajoyib? Har safar
autho‘zgarganda (foydalanuvchi login yoki logout qilganda),RouterProviderbutun router daraxtini qayta baholaydi va sahifadagibeforeLoadtekshiruvlarini avtomatik qayta ishga tushiradi!
3. React Router va TanStack Router RouterProvider taqqosi
| Xususiyat | React Router (RouterProvider) |
TanStack Router (RouterProvider) |
|---|---|---|
| Asosiy vazifasi | Routerni React daraxtiga ulash | Routerni React daraxtiga ulash |
| Qabul qiluvchi proplari | router, fallbackElement |
router, context, defaultPreload |
| Dinamik Context uzatish | Cheklangan (alohida Providerlar kerak) | To‘g‘ridan-to‘g‘ri context={{ ... }} prop mavjud |
| Type Safety tarqatilishi | Cheklangan (kasting talab qiladi) | declare module orqali butun ilovada 100% avtomatik |
| Miltillashdan himoya | Qo‘lda boshqariladi | defaultPendingMs sozlamasiga bo‘ysunadi |
Xulosa
RouterProvider— TanStack Router'ning butun kuchi va imkoniyatlarini React komponentlariga ochib beruvchi asosiy ko‘prikdir.declare module '@tanstack/react-router'orqali router turlari ilovaning barcha qismlariga yetkaziladi.contextprop orqali autentifikatsiya, til yoki TanStack Query kabi jonli ma'lumotlarni bevosita routerga uzatish va marshrutlarni avtomatik qayta tekshirtirish mumkin.