RouterProvider — Data Router'ni React ilovasiga ulash
React Router'da RouterProvider komponenti: Data Routerni ilovaga ulash, fallbackElement prop'i, boshqa global providerlar (Theme, Auth, Redux) bilan birga qo'llash.
46-dars
RouterProvider — Data Router'ni React ilovasiga ulash
Tasavvur qiling, siz yangi zamonaviy bino uchun eng so‘nggi rusumdagi kuchli elektr generatorini (createBrowserRouter) sotib oldingiz. Unda barcha xonalar, yo‘laklar va liftlarning elektr tarmog‘i xaritasi tayyor qilib qo‘yilgan.
Lekin bu qudratli generatorni binoning markaziy taqsimlash qutisiga (shitiga) ulovchi asosiy qalin kabel bo‘lmasa, binodagi bitta ham chiroq yonmaydi va xonalar qorong‘ulikda qoladi.
React Router Data API olamida <RouterProvider /> komponenti aynan mana shu "asosiy ulovchi kabel" vazifasini bajaradi. U createBrowserRouter orqali tuzilgan barcha marshrutlar va Data API xaritasini butun React komponentlar daraxtiga ulab, elektr quvvati kabi barcha imkoniyatlarni tarqatib beradi.
<RouterProvider /> nima va u nima uchun kerak?
React Router 6.4+ arxitekturasida eski uslubdagi <BrowserRouter> va <Routes> teglari butunlay almashtirildi.
Endilikda ilovaning kirish nuqtasida faqat bitta yagona <RouterProvider router={router} /> turadi:
graph TD
A["createBrowserRouter(routes)"] -->|router obyekti| B["<RouterProvider router={router} />"]
B --> C["1. Barcha sahifalarga Route Context tarqatiladi"]
B --> D["2. useLoaderData() va useActionData() hooklari faollashadi"]
B --> E["3. useNavigation() va <ScrollRestoration /> ishga tushadi"]
Asosiy vazifalari:
- Router instansiyasini qabul qilish: O‘zining majburiy
routerprop'i orqalicreateBrowserRouternatijasini oladi. - Data API'larni quvvatlash:
useLoaderData,useActionData,useNavigationvauseFetcherkabi barcha zamonaviy hook'lar aynan ushbu Provider ichidagina ishlay oladi. - Boshlang‘ich yuklanishni boshqarish: Dastlabki sahifa ochilayotganda
fallbackElementorqali chiroyli yuklanish ekranini ko‘rsatib turish.
<RouterProvider /> ning asosiy proplari
Komponent o‘zida quyidagi muhim xususiyatlarni qabul qiladi:
1. router (Majburiy)
createBrowserRouter, createMemoryRouter yoki createHashRouter orqali yaratilgan obyekt:
<RouterProvider router={router} />
2. fallbackElement (Ixtiyoriy)
Ilova ilk bor ochilayotgan paytda, boshlang‘ich sahifaning loader ma'lumotlari serverdan yuklanguncha ko‘rsatiladigan vaqtinchalik ekran (Splash Screen / Spinner):
<RouterProvider
router={router}
fallbackElement={<GlobalSplashScreen />}
/>
Amaliy loyiha: Arxitekturani to‘g‘ri ajratish
Professional jamoalarda router obyektini alohida faylda saqlash va main.tsx (yoki App.tsx) ichida uni <RouterProvider /> ga ulash tavsiya etiladi.
1-qadam: Router moduli (src/router.tsx)
import { createBrowserRouter } from 'react-router-dom';
import MainLayout from './layouts/MainLayout';
import HomePage from './pages/HomePage';
import CandidatesList, { candidatesLoader } from './pages/CandidatesList';
import CandidateDetail from './pages/CandidateDetail';
import NotFoundPage from './pages/NotFoundPage';
export const router = createBrowserRouter([
{
path: '/',
element: <MainLayout />,
errorElement: <NotFoundPage />,
children: [
{
index: true,
element: <HomePage />,
},
{
path: 'candidates',
element: <CandidatesList />,
loader: candidatesLoader, // Sahifaning ma'lumot yuklovchisi
},
{
path: 'candidates/:id',
element: <CandidateDetail />,
},
],
},
]);
2-qadam: Boshlang‘ich yuklanish indikatori (components/GlobalSplashScreen.tsx)
Dastur ilk bor ishga tushganda ko‘rsatiladigan chiroyli kutish oynasi:
export default function GlobalSplashScreen() {
return (
<div className="flex flex-col items-center justify-center min-h-screen bg-slate-900 text-white">
<div className="w-12 h-12 border-4 border-indigo-500 border-t-transparent rounded-full animate-spin mb-4"></div>
<h2 className="text-xl font-bold tracking-wide">HRMS Portal</h2>
<p className="text-slate-400 text-xs mt-1">Tizim ma'lumotlari yuklanmoqda...</p>
</div>
);
}
3-qadam: Ilovaga ulash (src/App.tsx yoki main.tsx)
import { RouterProvider } from 'react-router-dom';
import { router } from './router';
import GlobalSplashScreen from './components/GlobalSplashScreen';
export default function App() {
return (
<RouterProvider
router={router}
fallbackElement={<GlobalSplashScreen />}
/>
);
}
Boshqa global Providerlar (Theme, Redux, Auth) bilan qanday ulanadi?
Dasturchilar ko‘p so‘rashadi:
"Agar bizda Redux Provider, ThemeContext yoki TanStack Query bo‘lsa, ularni <RouterProvider /> ga qanday o‘raymiz?"
Qoida juda oddiy: barcha tashqi Providerlar <RouterProvider /> ning ustiga (tashqarisiga) o‘raladi:
import { RouterProvider } from 'react-router-dom';
import { Provider as ReduxProvider } from 'react-redux';
import { store } from './store';
import { ThemeProvider } from './context/ThemeContext';
import { AuthProvider } from './context/AuthContext';
import { router } from './router';
export default function App() {
return (
<ReduxProvider store={store}>
<ThemeProvider>
<AuthProvider>
{/* RouterProvider barcha ichki sahifalarga ushbu context'larni olib kiradi */}
<RouterProvider router={router} />
</AuthProvider>
</ThemeProvider>
</ReduxProvider>
);
}
Eng ko‘p qilinadigan xato
[!CAUTION] Data Router yaratib, uni
<BrowserRouter>ichiga solib qo‘yish!{/* ❌ QAT'IYAN XATO! */} const router = createBrowserRouter([...]); function App() { return ( <BrowserRouter> <Routes> ... </Routes> </BrowserRouter> ); }Agar
createBrowserRoutertuzilgan bo‘lsa, ilovangizda<BrowserRouter>umuman bo‘lmasligi kerak. Uning yagona qonuniy boshqaruvchisi faqat<RouterProvider router={router} />bo‘lishi lozim!
Xulosa
<RouterProvider />— React Router 6.4+ Data API arxitekturasining asosiy kirish komponenti.- U
createBrowserRouterorqali tuzilgan xaritani butun React ilovasiga ulaydi. fallbackElementorqali dastlabki ma'lumotlar yuklanguncha splash screen ko‘rsatish imkonini beradi.- Redux, Theme va Auth Providerlar har doim
<RouterProvider />ning tashqarisiga o‘raladi.