Seriya: React Basics Dars 26

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, className va 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.