Seriya: React Router Dars 64

React Router Framework Mode — Framework rejimining arxitekturasi

React Router v7 Framework Mode: Remix arxitekturasining birlashishi, server-side rendering (SSR), fayl-asosli marshrutlash (file-based routing) va full-stack imkoniyatlari.

64-dars

React Router Framework Mode — Framework rejimining arxitekturasi

Tasavvur qiling, siz ilgari garajda har xil qismlarni (motor, g‘ildiraklar, rul, elektr simlari) alohida-alohida sotib olib, o‘zingiz qo‘lda mashina yasayotgan edingiz (ya'ni Vite + React + React Router + alohida SSR sozlamalari). Bu usul erkinlik berardi, ammo juda ko‘p sozlash vaqtini talab qilardi.

Endi esa sizga zavodda barcha xavfsizlik sinovlaridan o‘tgan, salonida qulayliklari, aerodinamikasi va tayyor dvigateli o‘rnatilgan zamonaviy poyga avtomobili topshirildi.

React Router Framework Mode (React Router v7 bilan birga to‘liq birlashgan rejim — ilgari Remix deb atalgan arxitektura) — bu shunchaki brauzerdagi client-side kutubxona emas, balki to‘laqonli Full-Stack veb-freymvorkdir. U orqali siz frontend, backend (server mantiqlari), SEO va marshrutlarni yagona ekotizimda boshqarasiz.


Library Mode va Framework Mode farqi

React Router v7 da ilovalarni 2 xil rejimda qurish mumkin:

flowchart TD
    subgraph LibraryMode["1. Library Mode (Klassik SPA)"]
        A["Faqat brauzerda ishlaydi"] --> B["createBrowserRouter([])"]
        B --> C["Bo'sh HTML yuklanadi, JS sahifani chizadi"]
        C --> D["SEO va Initial Load sekinroq"]
    end

    subgraph FrameworkMode["2. Framework Mode (Full-Stack)"]
        E["Server va Brauzerda ishlaydi (SSR)"] --> F["Fayl/Konfiguratsiya asosli marshrutlar"]
        F --> G["Serverda tayyor HTML generatsiya bo'ladi"]
        G --> H["SEO a'lo darajada, Initial Load juda tez!"]
    end

3 ta asosiy ustun:

  1. Server-Side Rendering (SSR) & Streaming: Sahifa kodi avval serverda bajariladi va foydalanuvchiga tayyor HTML bo‘lib yetib boradi. Qidiruv botlari (Google, Yandex) saytni mukammal indekslaydi.
  2. Serverda ishlovchi Loader va Action'lar: Ma'lumotlarni yuklash (loader) va o‘zgartirish (action) funksiyalari to‘g‘ridan-to‘g‘ri serverda (Node.js/Bun) ishlaydi. Bu shuni anglatadiki, siz ularning ichida to‘g‘ridan-to‘g‘ri ma'lumotlar bazasiga (Prisma, PostgreSQL) ulanishingiz yoki maxfiy API kalitlarni (process.env.SECRET_KEY) bemalol ishlatishingiz mumkin — bu kodlar brauzerga umuman bormaydi!
  3. Avtomatik Type-Safety (./+types/...): React Router v7 loyihadagi marshrutlarga qarab TypeScript turlarini fonda o‘zi avtomatik generatsiya qiladi. Dasturchi useLoaderData ga qo‘lda as Type deb yozib o‘tirishi shart emas!

1. Framework rejimida loyiha tuzilishi

Framework Mode bilan yaratilgan loyiha odatda quyidagi toza strukturaga ega bo‘ladi:

my-react-router-app/
├── app/
│   ├── root.tsx                  # Butun saytning ota qobig'i (<html>, <head>, Global Layout)
│   ├── routes.ts                 # Marshrutlar xaritasi (v7 standarti)
│   └── routes/
│       ├── home.tsx              # Asosiy sahifa ( / )
│       ├── login.tsx             # Kirish sahifasi ( /login )
│       └── dashboard.tsx         # Dashboard layouti
│           └── candidates.tsx    # Nomzodlar sahifasi ( /dashboard/candidates )
├── public/                       # Statik rasmlar, favicon
├── vite.config.ts                # React Router v7 Vite plagini
└── package.json

2. To'liq Full-Stack sahifa kodi

Keling, app/routes/candidates.tsx faylida server mantiqlari va UI qanday qilib bitta faylda birikishini ko‘ramiz:

// app/routes/candidates.tsx
import type { Route } from "./+types/candidates"; // Avtomatik generatsiya qilingan turlar!

// 1. LOADER: Faqat SERVERDA bajariladi!
// Brauzer bu funksiyaning kodini ko'rmaydi, faqat natijaviy JSONni qabul qiladi.
export async function loader({ request }: Route.LoaderArgs) {
  // Masalan: To'g'ridan-to'g'ri maxfiy token orqali ichki API yoki Baza bilan ishlash
  const response = await fetch("https://api.hr-dashboard.uz/candidates", {
    headers: {
      Authorization: `Bearer ${process.env.INTERNAL_API_SECRET}`,
    },
  });

  if (!response.ok) {
    throw new Response("Nomzodlarni yuklab bo'lmadi", { status: response.status });
  }

  const candidates = await response.json();
  return { candidates };
}

// 2. ACTION: Forma yuborilganda faqat SERVERDA bajariladi!
export async function action({ request }: Route.ActionArgs) {
  const formData = await request.formData();
  const name = formData.get("name");

  // Serverda yangi nomzodni saqlash
  console.log("Serverda saqlandi:", name);
  return { success: true };
}

// 3. COMPONENT: Serverda SSR bo'lib, keyin brauzerda jonlanadi (Hydration)
export default function CandidatesPage({ loaderData }: Route.ComponentProps) {
  // loaderData avtomatik ravishda loader'dan kelgan turlarga ega!
  return (
    <div style={{ maxWidth: "600px", margin: "30px auto", padding: "20px" }}>
      <h1>Nomzodlar Ro'yxati (Framework Mode 🚀)</h1>
      <p style={{ color: "#6b7280" }}>
        Ushbu sahifa serverda SSR rejimida tayyorlanib, brauzerga uzatildi.
      </p>

      <ul>
        {loaderData.candidates.map((c: any) => (
          <li key={c.id}>
            <strong>{c.name}</strong> — {c.position}
          </li>
        ))}
      </ul>
    </div>
  );
}

3. Butun saytning poydevori: app/root.tsx

Framework rejimida butun HTML hujjati ham bitta React komponenti sifatida boshqariladi:

// app/root.tsx
import {
  Links,
  Meta,
  Outlet,
  Scripts,
  ScrollRestoration,
} from "react-router";

export default function Root() {
  return (
    <html lang="uz">
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
        <Meta />
        <Links />
      </head>
      <body>
        {/* Sahifalar aynan shu Outlet ichida almashadi */}
        <Outlet />

        {/* Scroll pozitsiyasini avtomatik eslab qolish */}
        <ScrollRestoration />
        {/* Brauzerda JavaScript'ni jonlantirish (Hydration) skriptlari */}
        <Scripts />
      </body>
    </html>
  );
}

Library Mode va Framework Mode taqqoslash jadvali

Mezon Library Mode (Klassik React Router) Framework Mode (React Router v7)
Qurilishi Faqat Client SPA (Brauzer) Full-Stack (Server + Brauzer)
Loader / Action qayerda ishlaydi? Brauzerda (Client-side fetch) Serverda (Maxfiy kalitlar, to‘g‘ridan-to‘g‘ri baza)
SEO va Qidiruv tizimlari Qiyinroq (Pre-rendering talab etadi) Mukammal (Tayyor HTML uzatiladi)
Boshlang‘ich tezlik (FCP) O‘rtacha (avval JS, keyin ma'lumot) Maksimal tezlik (Darhol HTML ko‘rinadi)
TypeScript integratsiyasi as Type kastingi talab qilinadi ./+types orqali 100% avtomatik Type-Safety

Xulosa

  • React Router Framework Mode — React Router va Remix ekotizimlarining birlashuvidan hosil bo‘lgan zamonaviy full-stack arxitekturadir.
  • U frontend bilan backend o‘rtasidagi chegarani yo‘qotib, server-side rendering, avtomatik kod bo‘lish va xavfsiz server operatsiyalarini bitta qulay muhitda taqdim etadi.
  • Bu rejim yordamida nafaqat oddiy boshqaruv panellari (dashboard), balki qidiruv tizimlari uchun optimallashgan yirik internet-do‘konlar va korporativ portallarni osonlik bilan qurish mumkin.