Series: React Router Lesson 33

Route configuration va reusable layouts — Katta route tree'ni tartibga solish

Katta React Router loyihalarida marshrutlar daraxtini (Route tree) modullarga ajratish, qayta ishlatiluvchi layoutlar (Reusable Layouts) va toza arxitektura qurish.

33-dars

Route configuration va reusable layouts — Katta route tree'ni tartibga solish

Tasavvur qiling, siz poytaxtdagi eng yirik ko‘p qavatli savdo majmuasini boshqaryapsiz. Majmuada yuzlab xalqaro kiyim do‘konlari, o‘nlab restoranlar, kinoteatrlar va ma'muriy ofislar faoliyat yuritadi.

Agar siz majmuadagi barcha do‘konlarning qoidalari, ish vaqti va eshik raqamlarini bitta ulkan qog‘oz varag‘iga ketma-ket yozib chiqsangiz, birorta xodim bu xaritani oxirigacha o‘qiy olmaydi va adashib ketadi. Buning o‘rniga har bir qavat va bo‘lim o‘zining mustaqil kichik xaritasiga ega bo‘ladi. Umumiy infratuzilma (eskalatorlar, liftlar, dam olish zonalari) esa hamma uchun qayta ishlatiladigan (reusable) umumiy qolip sifatida xizmat qiladi.

Veb-ilovalar ham kattalashib borgani sari o‘nlab, yuzlab sahifalarga ega bo‘ladi. Barcha route'larni bitta monolit App.tsx fayliga tiqib qo‘yish kodni boshqarib bo‘lmaydigan chalkash "makaron kodga" aylantiradi. Route configuration va Reusable layouts — bu yirik ilovalardagi route daraxtini (Route tree) mantiqiy modullarga bo‘lish va umumiy qoliplardan oqilona foydalanish san'atidir.


Monolit vs Modulli arxitektura

Keling, kichik startap va yirik korporativ ilovadagi marshrutlash farqini ko‘raylik:

graph TD
    subgraph Monolit Yondashuv (Chalkash)
        A["App.tsx (2000+ qator)"] --> A1["Barcha Auth + Dashboard + Candidates + Settings + Analytics bitta joyda"]
        A1 --> A2["❌ Git'da doimiy konfliktlar<br/>❌ Kodni o'qish qiyin"]
    end

    subgraph Modulli Yondashuv (Toza Arxitektura)
        M["AppRoutes.tsx (Markaziy dispetcher)"]
        M --> L["Reusable MainLayout"]
        L --> R1["candidateRoutes.tsx"]
        L --> R2["settingsRoutes.tsx"]
        L --> R3["analyticsRoutes.tsx"]
        M --> AL["AuthLayout"]
        AL --> R4["authRoutes.tsx"]
    end

Modulli yondashuvning 3 ta asosiy yutug‘i:

  1. Mas'uliyatni ajratish (Separation of Concerns): Nomzodlar moduli bo‘yicha ishlayotgan dasturchi faqat candidateRoutes.tsx faylini o‘zgartiradi va butun sayt xaritasini buzib qo‘yishdan qo‘rqmaydi.
  2. Git konfliktlarining yo‘qolishi: 5 nafar dasturchi bir vaqtda turli bo‘limlar route'larini yaratsa ham, ularning ishlari bitta faylda to‘qnash kelmaydi.
  3. Qayta ishlatiluvchanlik (Reusability): Bitta MainLayout komponenti 50 ta turli sahifaga umumiy ramka (Sidebar + Header) berib turaveradi.

Tavsiya etilgan papkalar tuzilishi (Folder Structure)

Yirik korporativ loyihalarda marshrutlarni quyidagicha tashkil qilish eng yaxshi amaliyot (Best Practice) hisoblanadi:

src/
├── layouts/
│   ├── MainLayout.tsx         # Asosiy boshqaruv ramkasi (Sidebar + Header + Outlet)
│   ├── AuthLayout.tsx         # Kirish sahifalari ramkasi (Markazlashtirilgan quti)
│   └── SettingsLayout.tsx     # Sozlamalar bo'limining ichki ramkasi
├── routes/
│   ├── AppRoutes.tsx          # Barcha modullarni birlashtiruvchi bosh dispetcher
│   ├── candidateRoutes.tsx    # Nomzodlar bo'limi route'lari
│   ├── settingsRoutes.tsx     # Sozlamalar bo'limi route'lari
│   └── authRoutes.tsx         # Kirish/ro'yxatdan o'tish route'lari

Bosqichma-bosqich amaliy amalga oshirish

1-qadam: Qayta ishlatiladigan umumiy Layout (layouts/MainLayout.tsx)

Ushbu layout o‘ziga biriktirilgan istalgan sahifani o‘z ichidagi <Outlet /> darchasiga qabul qiladi:

import { Outlet } from 'react-router-dom';
import Sidebar from '../components/Sidebar';
import Header from '../components/Header';

export default function MainLayout() {
  return (
    <div className="flex min-h-screen bg-slate-50">
      {/* 1. Umumiy chap menyu */}
      <Sidebar />

      {/* 2. Asosiy ishchi maydon */}
      <div className="flex-1 flex flex-col">
        <Header />
        
        <main className="flex-1 p-8">
          {/* Har qanday bolakay sahifa shu yerga kelib tushadi */}
          <Outlet />
        </main>
      </div>
    </div>
  );
}

2-qadam: Bo‘limlar bo‘yicha alohida route moduli (routes/candidateRoutes.tsx)

Nomzodlar bo‘limining barcha ichki sahifalarini (ro‘yxat, yangi qo‘shish, batafsil sahifa) alohida JSX fragmenti sifatida eksport qilamiz:

import { Route } from 'react-router-dom';
import CandidatesList from '../pages/candidates/CandidatesList';
import CandidateDetail from '../pages/candidates/CandidateDetail';
import CandidateNew from '../pages/candidates/CandidateNew';

// Nomzodlar bo'limining to'liq route shajarasi
export const candidateRoutes = (
  <Route path="candidates">
    <Route index element={<CandidatesList />} />
    <Route path="new" element={<CandidateNew />} />
    <Route path=":id" element={<CandidateDetail />} />
  </Route>
);

3-qadam: Boshqa bo‘lim moduli (routes/settingsRoutes.tsx)

Xuddi shunday, sozlamalar bo‘limi ham o‘z faylida alohida yoziladi:

import { Route } from 'react-router-dom';
import ProfileSettings from '../pages/settings/ProfileSettings';
import SecuritySettings from '../pages/settings/SecuritySettings';

export const settingsRoutes = (
  <Route path="settings">
    <Route index element={<ProfileSettings />} />
    <Route path="security" element={<SecuritySettings />} />
  </Route>
);

4-qadam: Markaziy dispetcher konfiguratsiyasi (routes/AppRoutes.tsx)

Endi asosiy ilova marshrut fayli juda ixcham, toza va o‘qilishi nihoyatda oson ko‘rinishga ega bo‘ladi:

import { Routes, Route } from 'react-router-dom';
import MainLayout from '../layouts/MainLayout';
import AuthLayout from '../layouts/AuthLayout';
import HomePage from '../pages/HomePage';
import LoginPage from '../pages/auth/LoginPage';
import NotFoundPage from '../pages/NotFoundPage';

// Bo'limlarning modulli route'larini chaqirib olamiz:
import { candidateRoutes } from './candidateRoutes';
import { settingsRoutes } from './settingsRoutes';

export default function AppRoutes() {
  return (
    <Routes>
      {/* 1. Ommaviy sahifalar */}
      <Route path="/" element={<HomePage />} />

      {/* 2. Autentifikatsiya sahifalari (AuthLayout ichida) */}
      <Route element={<AuthLayout />}>
        <Route path="/login" element={<LoginPage />} />
      </Route>

      {/* 3. Boshqaruv paneli (MainLayout ichida modullar ulanadi) */}
      <Route path="/dashboard" element={<MainLayout />}>
        {/* Modulli route'larni to'g'ridan-to'g'ri joylashtiramiz: */}
        {candidateRoutes}
        {settingsRoutes}
      </Route>

      {/* 4. Global 404 xatolik */}
      <Route path="*" element={<NotFoundPage />} />
    </Routes>
  );
}

Nima o‘zgardi?

  1. AppRoutes.tsx ning hajmi: 2 000 qatordan atigi 35 qatorga tushdi!
  2. Kengaytirish osonligi: Ertaga yangi "Analitika" bo‘limi kerak bo‘lsa, shunchaki analyticsRoutes.tsx faylini yaratasiz va AppRoutes.tsx ichiga {analyticsRoutes} deb bitta qator qo‘shib qo‘yasiz.
  3. Qayta ishlatiluvchi dizayn: Yangi yaratilgan har qanday bo‘lim MainLayout orqali avtomatik ravishda umumiy Sidebar va Header'ga ega bo‘ladi.

Xulosa

  • Katta loyihalarda marshrutlarni bitta faylga yig‘ish texnik qarz (technical debt) keltirib chiqaradi.
  • Reusable Layouts — umumiy interfeys elementlarini bir joyda saqlab, bir nechta sahifalar guruhiga birdek xizmat ko‘rsatadi.
  • Modulli Route'lar — loyihani funksional bo‘limlar bo‘yicha alohida fayllarga ajratib, jamoaviy ishlash unumdorligini va kod tozaligini maksimal darajaga ko‘taradi.