Seriya: React Router Dars 45

createBrowserRouter — Route object asosida router yaratish

React Router 6.4+ dagi createBrowserRouter funksiyasi: RouteObject massivi asosida marshrutlash, RouterProvider, errorElement va Data API imkoniyatlarini yoqish.

45-dars

createBrowserRouter — Route object asosida router yaratish

Tasavvur qiling, siz katta osmono‘par bino qurmoqchisiz.

Eski usulda (JSX deklarativ usulida) siz har bir xonaning eshigini eshikma-eshik yurib, qo‘lda birma-bir o‘rnatib chiqardingiz. Xonalar ko‘paygan sari qaysi eshik qayerga olib borishini eslab qolish qiyinlashib ketardi.

createBrowserRouter esa — bu o‘sha binoning butun boshli muhandislik bosh rejasi (Arxitektura chizmasi)dir! Siz barcha qavatlar, xonalar, yo‘laklar, xavfsizlik qoidalari va zaxira chiqish eshiklarini bitta tartibli hujjatda (JavaScript obyektlari massivida) oldindan chizib chiqasiz va uni bosh quruvchiga (<RouterProvider />) topshirasiz.

React Router v6.4+ Data API arxitekturasining yuragi va poydevori aynan mana shu funksiya hisoblanadi.


createBrowserRouter nima uchun kerak?

graph TD
    A["createBrowserRouter([RouteObject])"] --> B["1. Toza JavaScript Obyektlari (JSX'siz)"]
    A --> C["2. Data API quvvati: loader, action, errorElement"]
    A --> D["3. <RouterProvider router={router} /> ilovaga ulaydi"]

2 ta asosiy inqilobiy o‘zgarish:

  1. JSX'dan toza obyektlarga o‘tish: Oldingidek <Routes> va <Route> teglari ichiga o‘ralashib o‘tirish shart emas. Barcha yo‘llar qat'iy tiplangan oddiy JavaScript massivi (RouteObject[]) shaklida e'lon qilinadi.
  2. Data API imkoniyatlarini yoqish: React Router’ning eng ilg‘or xususiyatlari — loader, action, errorElement, useNavigation va ScrollRestoration faqatgina createBrowserRouter orqali yaratilgan router'lardagina ishlaydi!

RouteObject anatomiyasi (Obyekt parametrlari)

Har bir marshrut quyidagi xususiyatlarga ega bo‘lgan obyekt sifatida yoziladi:

import type { RouteObject } from 'react-router-dom';

const route: RouteObject = {
  path: 'candidates',               // URL yo'li
  element: <CandidatesList />,       // Ekranga chiziladigan komponent
  errorElement: <RouteErrorBoundary />, // Xatolik yuz berganda chiqadigan sahifa
  loader: candidatesLoader,          // Sahifa ochilishidan oldin ma'lumot yuklovchi
  action: candidateAction,          // Forma yuborilganda ishlovchi
  children: [ ... ],                 // Ichma-ich (nested) bolakay route'lar
};

Amaliy loyiha: Obyektlar asosida to‘liq router qurish

Keling, HRMS tizimining barcha ochiq, himoyalangan va xatolik sahifalarini createBrowserRouter yordamida qadam-baqadam yig‘amiz.

1-qadam: Router konfiguratsiyasi (router.tsx)

import { createBrowserRouter } from 'react-router-dom';
import MainLayout from './layouts/MainLayout';
import HomePage from './pages/HomePage';
import LoginPage from './pages/LoginPage';
import CandidatesList from './pages/CandidatesList';
import CandidateDetail from './pages/CandidateDetail';
import CandidateNew from './pages/CandidateNew';
import SettingsPage from './pages/SettingsPage';
import NotFoundPage from './pages/NotFoundPage';
import RouteErrorPage from './pages/RouteErrorPage';

export const router = createBrowserRouter([
  // 1. Ommaviy bosh sahifa
  {
    path: '/',
    element: <HomePage />,
    errorElement: <RouteErrorPage />, // Shu sahifada xatolik chiqsa
  },

  // 2. Login sahifasi
  {
    path: '/login',
    element: <LoginPage />,
  },

  // 3. Asosiy Dashboard (Ota layout va Nested bolakaylar)
  {
    path: '/dashboard',
    element: <MainLayout />,
    errorElement: <RouteErrorPage />, // Butun dashboard uchun umumiy xatolik tutuvchi
    children: [
      {
        path: 'candidates',
        element: <CandidatesList />,
      },
      {
        path: 'candidates/new',
        element: <CandidateNew />,
      },
      {
        path: 'candidates/:id',
        element: <CandidateDetail />,
      },
      {
        path: 'settings',
        element: <SettingsPage />,
      },
    ],
  },

  // 4. Global 404 (Topilmagan sahifalar)
  {
    path: '*',
    element: <NotFoundPage />,
  },
]);

2-qadam: Ilovaga ulash (App.tsx yoki main.tsx)

Eski <BrowserRouter> o‘rniga endi faqat <RouterProvider /> komponenti ishlatiladi va unga yuqorida yaratilgan router uzatiladi:

import React from 'react';
import ReactDOM from 'react-dom/client';
import { RouterProvider } from 'react-router-dom';
import { router } from './router';
import './index.css';

ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
    {/* RouterProvider butun ilovaning boshqaruv markazidir */}
    <RouterProvider router={router} />
  </React.StrictMode>
);

Alternativ usul: JSX ko‘rinishini obyektga aylantirish

Agar sizga JSX sintaksisida (<Route>) yozish qulayroq bo‘lsa, React Router’da createRoutesFromElements degan maxsus yordamchi funksiya mavjud:

import {
  createBrowserRouter,
  createRoutesFromElements,
  Route,
  RouterProvider,
} from 'react-router-dom';

const router = createBrowserRouter(
  createRoutesFromElements(
    <Route path="/" element={<RootLayout />} errorElement={<RootError />}>
      <Route index element={<HomePage />} />
      <Route path="login" element={<LoginPage />} />
      <Route path="candidates" element={<CandidatesList />} />
    </Route>
  )
);

export default function App() {
  return <RouterProvider router={router} />;
}

[!NOTE] Ikkala usul ham kapot ostida bir xil ishlaydi! Biroq professional jamoalarda toza TypeScript obyektlari (RouteObject[]) afzal ko‘riladi, chunki ularni tahlil qilish, avtomatik testlash va dinamik marshrutlar tuzish ancha qulay.


Obyekt asosidagi konfiguratsiyaning 3 ta katta afzalligi

  1. Markazlashgan va toza arxitektura: Barcha marshrutlar bitta faylda xarita kabi kaftdek ko‘rinib turadi.
  2. Lokal xatoliklar nazorati (errorElement): Agar candidates sahifasida biror xatolik chiqsa, butun sayt o‘chib qolmaydi — faqat o‘sha sahifa o‘rnida chiroyli xatolik xabari chiqadi, Sidebar va Header esa ishlayveradi.
  3. Kodni bo‘lib yuklash (Lazy loading): Kelgusi darslarda ko‘ramiz, obyekt orqali sahifalarni lazy: () => import(...) qilish juda oson.

Xulosa

  • createBrowserRouter — zamonaviy React Router 6.4+ ilovalarining boshlang‘ich nuqtasidir.
  • U marshrutlarni JSX emas, toza RouteObject massivi sifatida qabul qiladi.
  • Uning yordamida yaratilgan router ilovaga <RouterProvider router={router} /> orqali ulanadi va barcha Data API imkoniyatlarini to‘liq ochib beradi.