Seriya: React Basics Dars 78

Typing children va ReactNode — Komponent bolalarini to‘g‘ri tipizatsiya qilish

React va TypeScript'da children prop'ini tiplashtirish, ReactNode, ReactElement va PropsWithChildren turlari orasidagi farqlar.

78-dars

Typing children va ReactNode — Komponent bolalarini to‘g‘ri tipizatsiya qilish

React ilovalarini yaratish jarayonida ko'pincha boshqa elementlarni o'z ichiga qamrab oluvchi o'rovchi (wrapper) komponentlar — masalan, Card, Modal, Layout, Container yoki Providerlar yozamiz. Bunday komponentlar o'z teglari orasiga joylashtirilgan har qanday kontentni maxsus children prop'i orqali qabul qilib oladi. TypeScript'da bu bolalarni to'g'ri, xavfsiz va moslashuvchan tiplashtirish eng muhim amaliyotlardan biridir.


Asosiy turlar: Qaysi birini tanlash kerak?

React'da children uchun bir nechta turlar mavjud bo'lib, ularning qamrovi va vazifasi turlicha:

1. React.ReactNode (Eng tavsiya etilgan va universali)

  • Bu tur eng keng qamrovli bo'lib, React ekranga chiqara oladigan (renderable) deyarli hamma narsani o'z ichiga oladi:
    • Oddiy matn (string);
    • Sonlar (number);
    • JSX elementlari (<div />, <MyComponent />);
    • Elementlar massivi (ReactNode[]);
    • null, undefined yoki mantiqiy qiymatlar (boolean).
  • Qachon ishlatiladi? Agar komponentingiz o'z ichiga istalgan narsani (matn, tugma, boshqa komponentlar aralashmasi) qabul qilishi mumkin bo'lsa, doimo React.ReactNode tanlanadi.

2. React.ReactElement

  • Faqatgina bitta haqiqiy JSX elementini (masalan, <button /> yoki <CustomWidget />) qabul qiladi.
  • U oddiy matn (string) yoki sonlarni qabul qilmaydi.
  • Qachon ishlatiladi? Agar komponent bolasi ustida React.cloneElement kabi maxsus manipulyatsiyalar bajarish kerak bo'lsa yoki bola faqat bitta element bo'lishi qat'iy talab etilsa.

3. PropsWithChildren<P> (Yordamchi generic tur)

  • Har safar children: React.ReactNode deb qo'lda yozib o'tirmaslik uchun React'ning tayyor yordamchisi:
    type CardProps = PropsWithChildren<{
      title: string;
    }>;
    

Turlar taqqoslash jadvali

Xususiyat React.ReactNode React.ReactElement PropsWithChildren<P>
Matn / Raqam (string, number) Qabul qiladi ✅ Qabul qilmaydi ❌ Qabul qiladi ✅
JSX Elementlar (<div />) Qabul qiladi ✅ Qabul qiladi ✅ Qabul qiladi ✅
Elementlar massivi Qabul qiladi ✅ Qabul qilmaydi ❌ Qabul qiladi ✅
null / undefined Qabul qiladi ✅ Qabul qilmaydi ❌ Qabul qiladi ✅
Tavsiya darajasi 95% holatlarda standart ✅ Maxsus kamyob holatlarda Kodingizni qisqartirish uchun

[!IMPORTANT] Nega React.FC dan voz kechilgan? React 18 versiyasigacha ko'pchilik const Card: React.FC<CardProps> yozardi. Ammo React.FC komponentga har doim yashirincha children qo'shib qo'ygan (hatto bolasi bo'lmasligi kerak bo'lgan komponentlarga ham!). Zamonaviy standartda esa props ichida children: React.ReactNodeni ochiq ko'rsatish eng toza va xavfsiz yo'l hisoblanadi.


Kodda qanday ko'rinadi?

Keling, istalgan turdagi kontentni qabul qila oladigan universal Card komponentini React.ReactNode yordamida tiplashtirib ko'ramiz:

import React, { ReactNode } from 'react';

// 1. Props interfeysi (children majburiy yoki optional bo'lishi mumkin)
type CardProps = {
  title: string;
  children: ReactNode; // Istalgan narsani (matn, JSX, massiv) qabul qiladi
};

// 2. Komponentni yozish
export function Card({ title, children }: CardProps) {
  return (
    <div
      style={{
        padding: '16px',
        border: '1px solid #cbd5e1',
        borderRadius: '8px',
        maxWidth: '320px',
        backgroundColor: '#f8fafc',
      }}
    >
      <h3
        style={{
          margin: '0 0 12px 0',
          borderBottom: '1px solid #e2e8f0',
          paddingBottom: '6px',
          color: '#0f172a',
        }}
      >
        {title}
      </h3>

      {/* children shu yerda ochiladi */}
      <div style={{ fontSize: '14px', color: '#334155' }}>
        {children}
      </div>
    </div>
  );
}

// ==========================================
// 3. ISHLATILISH MISOLI:
// ==========================================
export default function App() {
  return (
    <div style={{ padding: '16px', display: 'flex', flexDirection: 'column', gap: '16px' }}>
      {/* 1. Matn va tugmalar aralashmasi */}
      <Card title="Foydalanuvchi ma'lumoti">
        <p style={{ margin: '0 0 4px 0' }}>Ism: <strong>Anvarbek</strong></p>
        <p style={{ margin: '0 0 10px 0' }}>Kasb: <strong>Dasturchi</strong></p>
        <button
          style={{
            padding: '6px 12px',
            backgroundColor: '#2563eb',
            color: 'white',
            border: 'none',
            borderRadius: '4px',
            cursor: 'pointer',
          }}
        >
          Batafsil
        </button>
      </Card>

      {/* 2. Shunchaki oddiy matn */}
      <Card title="Tezkor xabar">
        Saytimizda ta'mirlash ishlari olib borilmoqda.
      </Card>
    </div>
  );
}

[!TIP] Optional children: Agar komponentingiz ichi ba'zida bo'sh qolishi ham mumkin bo'lsa, children?: ReactNode (so'roq belgisi bilan) deb yozing. Bu holda komponentni <Card title="Bo'sh kartochka" /> ko'rinishida ham xatosiz chaqirish mumkin bo'ladi.


Real hayotiy misol: Sovg'a qutisi va uning ichidagilar

  • Sovg'a qutisi (Card wrapper): Sizda chiroyli quti bor. Uning vazifasi — ichidagi narsalarni tartibli qilib ushlab turish va chiroyli ko'rsatish.
  • React.ReactNode (Istalgan sovg'a): Bu qutining ichiga siz xat solishingiz, kitob qo'yishingiz, shirinliklar yoki shunchaki tabriknoma solishingiz mumkin — quti qanday buyum solinishidan qat'i nazar o'z vazifasini bekamu-ko'st bajaraveradi.
  • React.ReactElement (Faqat bitta maxsus buyum): Bu esa qutiga qat'iy shart qo'yishga o'xshaydi: "Bu qutiga faqat bitta soat solish mumkin, hech qanday qog'oz yoki konfet qabul qilinmaydi".
  • Ko'p hollarda bizga aynan React.ReactNode kabi erkin va universal sovg'a qutisi kerak bo'ladi.