useLoaderData — Loader ma'lumotlarini komponentda ishlatish
React Router'da useLoaderData hook'i: loader qaytargan ma'lumotlarni komponentda qabul qilish, TypeScript type safety, response handling va toza UI arxitekturasi.
48-dars
useLoaderData — Loader ma'lumotlarini komponentda ishlatish
Tasavvur qiling, oldingi darsda biz restoranning oshxonasida (loader funksiyasida) barcha taomlarni oldindan pishirib qo‘yishni o‘rgandik. useLoaderData — bu o‘sha tayyor taomni to‘g‘ridan-to‘g‘ri stolga keltirib, mehmonning (ya'ni React komponentining) oldiga qo‘yadigan chaqqon ofitsiantdir.
Siz endi komponent ichida useState ochib, useEffect yozib, serverdan ma'lumot kelishini kutib bo‘sh stakanlarni ko‘rsatib o‘tirmaysiz. Komponent render bo‘lishi bilanoq, useLoaderData orqali serverdan yuklab qo‘yilgan tayyor ma'lumotlarni darhol qo‘lingizga olasiz!
useLoaderData nima va u qanday ishlaydi?
useLoaderData — bu React Router v6.4+ bilan taqdim etilgan maxsus hook bo‘lib, joriy route'ning loader funksiyasi qaytargan (return) ma'lumotni komponent ichida olish uchun xizmat qiladi.
flowchart LR
A["URL o'zgardi (/candidates/12)"] --> B["Router loader() funksiyasini chaqiradi"]
B --> C["Serverdan ma'lumot keldi (Candidate obyekti)"]
C --> D["Komponent birinchi marta render bo'ladi"]
D --> E["const candidate = useLoaderData()"]
Asosiy xususiyatlari:
- Sinxron qabul qilish: Ma'lumot allaqachon
loadertomonidan yuklab bo‘linganligi sababli,useLoaderData()hech qandayasync/awaittalab qilmaydi — u ma'lumotni darhol qaytaradi. - Kodni tozalash: Komponentingizdan
useEffect,useState,isLoadingbayroqlari kabi ortiqcha kodlar butunlay olib tashlanadi. - Response'ni avtomatik ochish: Agar sizning
loaderfunksiyangizfetchnatijasidagiResponseobyektini qaytarsa, React Router uning ichidagi JSON ma'lumotlarini komponentga avtomatik tarzda ochib (response.json()) beradi.
1. Amaliy misol: Dinamik nomzod sahifasi (CandidateDetail)
Keling, nomzodning batafsil profilini ko‘rsatadigan sahifa misolida loader va useLoaderData bog‘lanishini ko‘rib chiqamiz.
1-qadam: TypeScript interfeysi va Loader funksiyasi
Avval nomzod ma'lumotlari turini va candidateDetailLoader funksiyasini yozamiz:
// src/pages/CandidateDetail.tsx
import { useLoaderData, type LoaderFunctionArgs } from "react-router-dom";
// 1. Ma'lumot turi
export interface Candidate {
id: string;
fullName: string;
role: string;
experienceYears: number;
skills: string[];
bio: string;
}
// 2. Loader funksiyasi (Komponentdan tashqarida e'lon qilinadi)
export async function candidateDetailLoader({ params }: LoaderFunctionArgs) {
const { candidateId } = params;
const response = await fetch(`https://api.example.com/candidates/${candidateId}`);
if (!response.ok) {
// Agar 404 yoki boshqa xatolik bo'lsa, xato tashlaymiz
throw new Response("Nomzod topilmadi", { status: response.status });
}
// Fetch'dan qaytgan Response obyektini to'g'ridan-to'g'ri return qilamiz
return response;
}
[!NOTE]
fetchqaytarganresponseobyektini qo‘ldaawait response.json()deb o‘tirish shart emas. React Router standart Web APIResponseobyektlarini o‘zi taniydi va ichidagi JSON ma'lumotlarini avtomatik ajratib oladi.
2-qadam: Komponent ichida useLoaderData bilan ma'lumotni o'qish
Endi sahifa komponentida useLoaderData hook'ini ishlatamiz:
// src/pages/CandidateDetail.tsx (davomi)
export function CandidateDetailPage() {
// 3. Tayyor ma'lumotni darhol qabul qilib olamiz
const candidate = useLoaderData() as Candidate;
return (
<div className="candidate-card">
<header className="card-header">
<h1>{candidate.fullName}</h1>
<span className="badge">{candidate.role}</span>
</header>
<section className="card-body">
<p><strong>Tajriba:</strong> {candidate.experienceYears} yil</p>
<p><strong>Haqida:</strong> {candidate.bio}</p>
<h3>Ko'nikmalar:</h3>
<ul className="skills-list">
{candidate.skills.map((skill) => (
<li key={skill} className="skill-item">{skill}</li>
))}
</ul>
</section>
</div>
);
}
Ko‘rib turganingizdek, komponent ichida bironta ham if (loading) yoki useEffect yo‘q! Komponent render bo‘lgan birinchi millisekundidayoq candidate ma'lumotlari mavjud bo‘ladi.
3-qadam: Routerni ulash (createBrowserRouter)
Yaratgan sahifamiz va loader'imizni marshrutga biriktiramiz:
// src/routes.tsx
import { createBrowserRouter } from "react-router-dom";
import { CandidateDetailPage, candidateDetailLoader } from "./pages/CandidateDetail";
import { CandidateErrorPage } from "./pages/CandidateError";
export const router = createBrowserRouter([
{
path: "/candidates/:candidateId",
element: <CandidateDetailPage />,
loader: candidateDetailLoader,
errorElement: <CandidateErrorPage /> // Xatolik yuz berganda avtomatik ishga tushadi
}
]);
2. TypeScript bilan Type-Safety (Xavfsiz turlar)
TypeScript'da useLoaderData() odatda unknown turini qaytaradi. Bunga sabab — React Router compile-time bosqichida loader qanday ma'lumot qaytarishini avtomatik aniqlay olmaydi.
Turlarni xavfsiz boshqarishning 2 ta asosiy usuli bor:
1-usul: Type Assertion (as Type) — Eng ommabop usul
Oddiy va tushunarli usul:
const candidate = useLoaderData() as Candidate;
2-usul: Maxsus Hook (Custom Typed Hook) — Eng xavfsiz arxitektura
Katta loyihalarda xatoliklarni oldini olish uchun komponent ichida alohida yordamchi hook yozish tavsiya etiladi:
// src/pages/CandidateDetail.tsx
export function useCandidateData(): Candidate {
return useLoaderData() as Candidate;
}
// Komponent ichida:
export function CandidateDetailPage() {
const candidate = useCandidateData(); // Aniq Candidate turiga ega!
return <div>{candidate.fullName}</div>;
}
[!TIP] Agar loader'ingiz bir nechta turli xil qiymatlarni (masalan, nomzod ma'lumotlari va kompaniya statistikasini) parallel yuklasa:
export async function candidateLoader() { const [candidate, stats] = await Promise.all([fetchCandidate(), fetchStats()]); return { candidate, stats }; } // Komponentda: const { candidate, stats } = useLoaderData() as { candidate: Candidate; stats: Stats; };
3. Eski usul (useEffect) va Yangi usul (useLoaderData) taqqosi
| Xususiyat | Eski usul (useEffect + useState) |
Yangi usul (useLoaderData) |
|---|---|---|
| Ma'lumot qachon yuklanadi? | Komponent render bo‘lgandan keyin (Water-fall) | Sahifaga o‘tish boshlanishi bilanoq (Render-as-you-fetch) |
| Kodni hajmi | useState, useEffect, isLoaded, error kabi 15-25 qator boilerplate |
1 qator: const data = useLoaderData() |
| Layout Shift (Sakrash) | Avval bo‘sh oq ekran yoki spinner chiqib, keyin kontent sakraydi | Sahifa faqat ma'lumot tayyor bo‘lganda silliq ochiladi |
| Xatoliklarni tutish | Har bir komponentda try/catch va if (error) yozish shart |
Router darajasidagi errorElement avtomatik tutib oladi |
| SEO va Caching | Qidiruv botlari bo‘sh sahifani ko‘rib ketishi mumkin | Sahifa to‘liq kontent bilan yuklanadi |
4. Muhim qoidalar va eslatmalar
[!WARNING]
useLoaderDatafaqat o‘ziga tegishli bo‘lgan route komponenti (yoki uning ichidagi child komponentlar) doirasida ishlaydi. Agar siz ushbu hook'nicreateBrowserRouterga ulanmagan yoki loader biriktirilmagan route'da chaqirsangiz, uundefinedqaytaradi yoki xatolik beradi.
[!IMPORTANT] Parent Route ma'lumotlarini qanday o'qiymiz? Agar sizga ota (parent) route'ning loader ma'lumotlari kerak bo'lsa,
useLoaderData()faqat joriy route ma'lumotini ko'rsatadi. Parent ma'lumotlarini olish uchunuseRouteLoaderData(routeId)hook'idan foydalaniladi (buni kelgusi darslarda batafsil ko'ramiz).
Xulosa
useLoaderData React Router'dagi eng qulay va kodni soddalashtiruvchi hook'lardan biridir:
- U
loaderyuklab bergan ma'lumotni komponentga to‘g‘ridan-to‘g‘ri, sinxron tarzda yetkazib beradi. - Komponentingizni murakkab holat boshqaruvidan (
useState,useEffect) xalos etadi va uni faqatgina vizual ko‘rinish (UI) bilan shug‘ullanishiga imkon yaratadi. - Xatoliklar yuz berganda
errorElementbilan birga uzviy ishlaydi.