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:
- 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.
- 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! - Avtomatik Type-Safety (
./+types/...): React Router v7 loyihadagi marshrutlarga qarab TypeScript turlarini fonda o‘zi avtomatik generatsiya qiladi. DasturchiuseLoaderDataga qo‘ldaas Typedeb 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.