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,undefinedyoki mantiqiy qiymatlar (boolean).
- Oddiy matn (
- Qachon ishlatiladi? Agar komponentingiz o'z ichiga istalgan narsani (matn, tugma, boshqa komponentlar aralashmasi) qabul qilishi mumkin bo'lsa, doimo
React.ReactNodetanlanadi.
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.cloneElementkabi 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.ReactNodedeb 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.FCdan voz kechilgan? React 18 versiyasigacha ko'pchilikconst Card: React.FC<CardProps>yozardi. AmmoReact.FCkomponentga har doim yashirinchachildrenqo'shib qo'ygan (hatto bolasi bo'lmasligi kerak bo'lgan komponentlarga ham!). Zamonaviy standartda esa props ichidachildren: 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 (
Cardwrapper): 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.ReactNodekabi erkin va universal sovg'a qutisi kerak bo'ladi.