re:re:actable
Урок 043 минуты чтения

Props и значения props по умолчанию

На этой странице
Кратко

Props — входные данные компонента: объект, который родитель передает ребенку через атрибуты JSX. Через props передают значения, объекты, функции-обработчики и JSX (children). Значения по умолчанию задают параметрами деструктуризации: function Button({ variant = "primary" }). Старый способ Component.defaultProps для функциональных компонентов в React 19 удален.

Вопрос

Что такое props в компоненте? Как задать значение props по умолчанию?

Основная идея

Props — единственный способ родителя настроить ребенка. Данные текут сверху вниз: родитель решает, что передать, ребенок только читает.

function Avatar({ src, name, size = 48 }) {
  return <img src={src} alt={name} width={size} height={size} />;
}
 
function Profile({ user }) {
  return (
    <section>
      <Avatar src={user.avatar} name={user.name} />
      <Avatar src={user.avatar} name={user.name} size={96} />
    </section>
  );
}

Через props можно передать что угодно:

ЧтоПример
Строки и числа<Avatar size={48} name="Анна" />
Boolean<Button disabled /> (= disabled={true})
Объекты и массивы<UserCard user={user} />
Функции<Button onClick={handleSave} />
JSX<Card header={<h2>Заголовок</h2>}>...</Card>
Компоненты<List renderItem={Item} />

Поток данных

          ┌──────── Profile ────────┐
          │ state: user              │
          └──┬────────────────────▲──┘
   props вниз │ user, onRename      │ вызов колбэка вверх
             ▼                      │
          ┌──────── Avatar ─────────┐
          │ читает props, не меняет  │
          │ onRename("Новое имя") ───┘
          └──────────────────────────┘

Props — как аргументы функции: компонент их получает и использует, но не переписывает.

Значения по умолчанию

function Button({ variant = "primary", size = "md", type = "button", children, ...rest }) {
  return (
    <button type={type} className={`btn btn--${variant} btn--${size}`} {...rest}>
      {children}
    </button>
  );
}
  • значение по умолчанию применяется, если prop не передан или равен undefined;
  • при null дефолт не применяется;
  • объект или массив по умолчанию в параметре создается заново на каждом рендере — это ломает мемоизацию: выносите константу наружу компонента.
const EMPTY = [];
function List({ items = EMPTY }) {}

Передача всех props

function Input({ label, ...inputProps }) {
  return (
    <label>
      {label}
      <input {...inputProps} />
    </label>
  );
}

Spread удобен для оберток, но скрывает, какие props поддерживаются, — в TypeScript типизируйте их через ComponentProps<"input">.

Частые ошибки

// ✗ Строка вместо числа: size станет "48", а сравнение size > 40 сработает неожиданно
<Avatar size="48" />
// ✓
<Avatar size={48} />
 
// ✗ Вызов функции при рендере вместо передачи
<Button onClick={save()} />
// ✓
<Button onClick={save} />
<Button onClick={() => save(id)} />
 
// ✗ defaultProps у функционального компонента — удалён в React 19
Button.defaultProps = { variant: "primary" };
// ✓
function Button({ variant = "primary" }) {}
 
// ⚠ null не заменяется значением по умолчанию
<Avatar size={null} /> // size === null, а не 48

Типизация props

type ButtonProps = {
  variant?: "primary" | "ghost";
  size?: "sm" | "md";
  children: React.ReactNode;
} & React.ComponentPropsWithoutRef<"button">;
 
function Button({ variant = "primary", size = "md", children, ...rest }: ButtonProps) {
  return <button className={`btn btn--${variant} btn--${size}`} {...rest}>{children}</button>;
}

Что важно помнить

  • Props только для чтения — менять их внутри ребенка нельзя.
  • key и (в React 18) ref не попадают в props; в React 19 ref доступен как обычный prop у функциональных компонентов.
  • Имя prop-обработчика по соглашению начинается с on: onSelect, а функция в родителе — с handle: handleSelect.
  • Слишком много props — сигнал разделить компонент или использовать композицию через children.

Мини-шпаргалка

Props — данные от родителя, только чтение. Передаются любые значения, функции и JSX. Default — в деструктуризации, срабатывает на undefined. defaultProps для функций — устарел.

Документация

React: Passing Props to a Component, React 19: Removed defaultProps for functions.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам