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 19refдоступен как обычный 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.