Seriya: React Router Dars 48

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:

  1. Sinxron qabul qilish: Ma'lumot allaqachon loader tomonidan yuklab bo‘linganligi sababli, useLoaderData() hech qanday async/await talab qilmaydi — u ma'lumotni darhol qaytaradi.
  2. Kodni tozalash: Komponentingizdan useEffect, useState, isLoading bayroqlari kabi ortiqcha kodlar butunlay olib tashlanadi.
  3. Response'ni avtomatik ochish: Agar sizning loader funksiyangiz fetch natijasidagi Response obyektini 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] fetch qaytargan response obyektini qo‘lda await response.json() deb o‘tirish shart emas. React Router standart Web API Response obyektlarini 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] useLoaderData faqat o‘ziga tegishli bo‘lgan route komponenti (yoki uning ichidagi child komponentlar) doirasida ishlaydi. Agar siz ushbu hook'ni createBrowserRouter ga ulanmagan yoki loader biriktirilmagan route'da chaqirsangiz, u undefined qaytaradi 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 uchun useRouteLoaderData(routeId) hook'idan foydalaniladi (buni kelgusi darslarda batafsil ko'ramiz).


Xulosa

useLoaderData React Router'dagi eng qulay va kodni soddalashtiruvchi hook'lardan biridir:

  • U loader yuklab 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 errorElement bilan birga uzviy ishlaydi.