Seriya: React Basics Dars 77

Generic components — Turli ma’lumotlar bilan ishlaydigan qayta ishlatiladigan komponentlar

React va TypeScript'da Generic komponentlar yaratish, <T> parametrlari, Type Inference, render props bilan integratsiya va DRY tamoyili.

77-dars

Generic components — Turli ma’lumotlar bilan ishlaydigan qayta ishlatiladigan komponentlar

React va TypeScript loyihalarida tez-tez shunday vaziyatga duch kelamizki, komponentning ichki vizual tuzilishi bir xil bo'ladi, lekin u qabul qiladigan ma'lumotlar turi mutlaqo har xil bo'lishi mumkin (masalan: foydalanuvchilar ro'yxati, mahsulotlar katalogi, xabarlar yoki shunchaki sonlar massivi). Har bir yangi ma'lumot turi uchun alohida nusxa ko'chirib o'tirmasdan, Generics (<T>) yordamida barcha turlar bilan birdek ishlay oladigan universal komponentlar yaratiladi.


Generic Component nima va u qanday muammoni hal qiladi?

Tasavvur qiling, bizga har qanday ma'lumotni ro'yxat ko'rinishida chiqarib beruvchi universal List komponenti kerak:

  • Agar unga qat'iy items: User[] deb yozsak, ertaga mahsulotlarni chiqarish uchun alohida ProductList komponentini noldan yozishimizga to'g'ri keladi.
  • Agar items: any[] deb yozsak, TypeScript'ning butun kuchi va xavfsizligi yo'qqa chiqadi.
  • Generic (<T>) esa komponentga: "Menga qanday turdagi (User, Product, string) massiv bersang, o'sha turga o'zim avtomatik moslashib olaman" deyish imkonini beradi.

Bu dasturlashdagi eng muhim DRY (Don't Repeat Yourself) tamoyilining oliy ko'rinishidir.


Type Inference: Turlarni avtomatik aniqlash

Generic komponentning eng katta qulayligi shundaki, uni ishlatayotganda <List<User> ... /> deb qo'lda tur ko'rsatish shart emas. TypeScript uzatilayotgan items={users} qiymatiga qarab T parametrini o'zi avtomatik tarzda User deb xulosa chiqaradi:

  • items={users} berilganda ➡️ renderItem={(user) => ...} ichidagi user avtomatik User tipiga aylanadi va uning barcha maydonlari (name, id) avtotugallashda ko'rinadi!
  • items={products} berilganda ➡️ renderItem={(product) => ...} ichidagi product avtomatik Product tipiga aylanadi.

Oddiy komponent vs Generic komponent

Mezon Oddiy Komponent Generic Komponent (<T>)
Moslashuvchanlik Faqat 1 ta aniq tip uchun Istalgan ma'lumot turi bilan ishlaydi ✅
Kodni takrorlash Har bir yangi obyekt uchun yangi komponent Bitta komponent barcha joyda qayta ishlatiladi ✅
Type-Safety Yaxshi, lekin cheklangan 100% to'liq va avtomatik Type Inference ✅
Qo'llanish joylari Maxsus alohida kartochkalar Ro'yxatlar, Jadvallar (Table), Select/Dropdown, Modal

[!IMPORTANT] Arrow Function sintaksisiga e'tibor bering! Agar generic komponentni oddiy function List<T>() emas, balki o'qsimon funksiya (arrow function) bilan yozmoqchi bo'lsangiz, TSX fayllarida JSX teglari bilan adashib ketmasligi uchun vergul qo'yiladi: const List = <T,>(props: ListProps<T>) => { ... } yoki <T extends unknown>.


Kodda qanday ko'rinadi?

Keling, istalgan turdagi ma'lumotlar bilan xavfsiz ishlovchi va renderItem naqshiga ega generic List komponentini ko'ramiz:

import React from 'react';

// 1. Generic Props: <T> har qanday ma'lumot turining o'rnini bosadi
type ListProps<T> = {
  items: T[]; // T turidagi elementlar massivi
  keyExtractor: (item: T) => string | number; // Unikal kalitni ajratib oluvchi funksiya
  renderItem: (item: T) => React.ReactNode; // Har bir elementni qanday chizishni belgilovchi funksiya
};

// 2. Generic Komponent funksiyasi
export function List<T>(props: ListProps<T>) {
  return (
    <ul style={{ paddingLeft: '20px', margin: 0 }}>
      {props.items.map((item) => (
        <li key={props.keyExtractor(item)} style={{ marginBottom: '6px', fontSize: '14px' }}>
          {props.renderItem(item)}
        </li>
      ))}
    </ul>
  );
}

// ==========================================
// 3. ISHLATILISH MISOLI:
// ==========================================

// Turli xil ma'lumot turlari
type User = { id: number; name: string };
type Product = { id: number; title: string; price: number };

export default function App() {
  const users: User[] = [
    { id: 1, name: "Anvarbek" },
    { id: 2, name: "Malika" },
  ];

  const products: Product[] = [
    { id: 101, title: "Noutbuk", price: 1200 },
    { id: 102, title: "Smartfon", price: 800 },
  ];

  return (
    <div style={{ padding: '16px', border: '1px solid #e2e8f0', borderRadius: '8px', maxWidth: '350px', display: 'flex', flexDirection: 'column', gap: '16px' }}>
      <h3 style={{ margin: 0 }}>Generic Components</h3>

      {/* 1. Foydalanuvchilar bilan ishlatish */}
      <div>
        <h4 style={{ margin: '0 0 8px 0', color: '#2563eb' }}>Foydalanuvchilar:</h4>
        <List
          items={users}
          keyExtractor={(user) => user.id}
          renderItem={(user) => <strong>{user.name}</strong>}
        />
      </div>

      {/* 2. Mahsulotlar bilan ishlatish */}
      <div>
        <h4 style={{ margin: '0 0 8px 0', color: '#059669' }}>Mahsulotlar:</h4>
        <List
          items={products}
          keyExtractor={(product) => product.id}
          renderItem={(product) => (
            <span>
              {product.title} — <strong>${product.price}</strong>
            </span>
          )}
        />
      </div>
    </div>
  );
}

[!TIP] Generic Constraints (extends bilan cheklash): Agar sizning komponentingizdagi har bir elementda majburiy ravishda id bo'lishi shart bo'lsa, generic'ni cheklash mumkin: function List<T extends { id: string | number }>(...). Bu holda alohida keyExtractor berish ham shart bo'lmay, to'g'ridan-to'g'ri item.iddan foydalanish mumkin bo'ladi.


Real hayotiy misol: Universal quyish mashinasi va har xil suyuqliklar

  • Universal mashina (Generic Component): Zavodda turli xil suyuqliklarni (mineral suv, meva sharbati, sut) shisha idishlarga quyib, qopqoq yopib beruvchi bitta zamonaviy universal konveyer mashinasi mavjud.
  • Har xil xomashyo (<T>): Mashinaning ishlash mexanizmi va idishlari bir xil bo'lib qolaveradi, faqat unga ulanadigan quvurdan oqib kelayotgan suyuqlik turi (Type) har safar o'zgaradi.
  • React'dagi Generic komponentlar ham xuddi shunday: komponentning tashqi skeleti va boshqaruv mexanizmi bir xil bo'lib qoladi, lekin unga beriladigan ma'lumotlar turi cheksiz moslashuvchan bo'ladi.