Component API design — Qayta ishlatiladigan komponentlarning props interfeysini to‘g‘ri loyihalash
React'da Component API dizayni, ButtonHTMLAttributes bilan kengaytirish, rest props va universal pult analogiyasi.
26-dars
Component API design — Qayta ishlatiladigan komponentlarning props interfeysini to‘g‘ri loyihalash
Katta va professional React ilovalarini yaratishda eng muhim qadamlardan biri bu — Component API design (Komponent API dizayni) hisoblanadi.
Component API design o'zi nima?
Komponent yaratish shunchaki uning kodini yozib qo'yish emas. Bu boshqa dasturchilar (yoki o'zingiz kelajakda) o'sha komponentdan foydalanganda uning props'lari qanchalik tushunarli, mantiqiy va qulay ekanligini loyihalash jarayonidir.
- Yaxshi dizayn: Props nomlari qisqa va aniq bo'ladi (
disabled,isLoading,onClick), ortiqcha va chalkash majburiy qiymatlar talab qilinmaydi. - Kengaytiriluvchanlik: Standart HTML elementlarining barcha xususiyatlarini (
onClick,disabled,classNameva hokazo) yo'qotib qo'ymasdan, ularni o'zimizning maxsus props'larimiz bilan mukammal birlashtira olamiz.
Kodda qanday ko'rinadi?
Keling, mukammal va professional darajada loyihalashtirilgan tugma (Button) komponenti API'sini ko'rib chiqamiz. U standart HTML tugmasining barcha imkoniyatlarini qo'llab-quvvatlaydi va o'zining maxsus qo'shimchalariga ega:
import React from 'react';
// 1. Standart HTML tugma atributlarini o'zimiznikilar bilan kengaytiramiz (extends)
interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
variant?: 'primary' | 'danger' | 'outline'; // Tugma turi
isLoading?: boolean; // Yuklanish holati
leftIcon?: React.ReactNode; // Chap tarafdagi kichik ikonka
}
// 2. Props'larni toza destructuring qilib, qolganlarini (...rest) HTML tugmaga uzatamiz
function Button({
children,
variant = 'primary',
isLoading = false,
leftIcon,
disabled,
style,
...rest
}: ButtonProps) {
// Variant bo'yicha ranglarni tanlash
const getBackgroundColor = () => {
if (variant === 'danger') return '#ef4444';
if (variant === 'outline') return 'transparent';
return '#2563eb';
};
return (
<button
disabled={disabled || isLoading}
style={{
backgroundColor: getBackgroundColor(),
color: variant === 'outline' ? '#2563eb' : 'white',
border: variant === 'outline' ? '1px solid #2563eb' : 'none',
padding: '10px 20px',
borderRadius: '6px',
cursor: (disabled || isLoading) ? 'not-allowed' : 'pointer',
display: 'inline-flex',
alignItems: 'center',
gap: '8px',
opacity: (disabled || isLoading) ? 0.6 : 1,
...style
}}
{...rest} // Boshqa barcha standart HTML atributlarini (onClick, type, id va h.k.) qabul qiladi
>
{isLoading ? "Yuklanmoqda..." : (
<>
{leftIcon && <span>{leftIcon}</span>}
{children}
</>
)}
</button>
);
}
// 3. Ishlatilish joyi (API qanchalik qulay ekaniga e'tibor bering)
function App() {
return (
<div style={{ display: 'flex', gap: '10px' }}>
<Button variant="primary" onClick={() => alert("Bosildi!")}>
Saqlash
</Button>
<Button variant="danger" isLoading={true}>
O'chirish
</Button>
</div>
);
}
Real hayotiy misol: Televizion pult yoki Universal rozetka
- Yomon dizayn: Agar pultdagi tugmalar tartibsiz, tushunarsiz va har xil g'alati qoidalarga ega bo'lsa, undan foydalanish azobga aylanadi.
- To'g'ri Component API design: Bu xuddi zamonaviy universal televizor pultiga o'xshaydi: asosiy tugmalar o'z joyida tushunarli turadi, ustiga ustak u barcha turdagi televizorlarga moslashadi. Sifatli component API ham boshqa dasturchilarga ortiqcha bosh og'riqsiz, eslab qolish oson bo'lgan qulay interfeys taqdim etadi.