Series: TanStack Router Lesson 8

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:

  1. URL o‘zgarishlarini kuzatish: Brauzerdagi manzil satri o‘zgarganda mos keluvchi sahifa komponentini topib, uni ekranga chizadi.
  2. Hooklar uchun muhit yaratish: useNavigate, useParams, useSearch va useLoaderData kabi hooklarning to‘g‘ri ishlashini ta'minlaydi.
  3. Pending va xatoliklar boshqaruvi: Sahifa yuklanayotganda defaultPendingComponentni va kutilmagan nosozliklarda defaultErrorComponentni 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 auth o‘zgarganda (foydalanuvchi login yoki logout qilganda), RouterProvider butun router daraxtini qayta baholaydi va sahifadagi beforeLoad tekshiruvlarini 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.
  • context prop orqali autentifikatsiya, til yoki TanStack Query kabi jonli ma'lumotlarni bevosita routerga uzatish va marshrutlarni avtomatik qayta tekshirtirish mumkin.