children и передача JSX внутрь другого компонента
На этой странице
children — специальный prop, в который попадает всё, что написано между открывающим и закрывающим тегом компонента: <Card>Содержимое</Card>. Через children создают обертки — карточки, модалки, layout. Если нужно передать несколько «слотов» JSX, используют обычные props: <Layout header={<Header />} sidebar={<Menu />}>. JSX — обычное значение, поэтому его можно передавать в любом prop.
Вопрос
Что такое children? Как передать JSX внутрь другого компонента?
Основная идея
function Card({ title, children }) {
return (
<section className="card">
<h2>{title}</h2>
<div className="card__body">{children}</div>
</section>
);
}
<Card title="Профиль">
<p>Анна Петрова</p>
<button>Редактировать</button>
</Card>;Card не знает, что внутри, — она только оформляет контейнер. Это основа композиции: универсальные обертки без десятков настроек.
Несколько слотов
function PageLayout({ header, sidebar, children }) {
return (
<div className="layout">
<header>{header}</header>
<aside>{sidebar}</aside>
<main>{children}</main>
</div>
);
}
<PageLayout header={<SiteHeader />} sidebar={<Filters />}>
<ProductGrid />
</PageLayout>;Что может быть в children
- JSX-элемент или несколько элементов;
- строка, число;
- массив элементов;
null,undefined,false— ничего не рендерится;- функция — паттерн «function as child», если компонент вызывает
children(data).
<DataLoader url="/api/users">
{(users) => <UserList users={users} />}
</DataLoader>children и производительность
Элементы, переданные через children, создаются в родителе. Если обертка перерендерится из-за своего состояния, children не пересоздаются, и вложенные компоненты могут не рендериться заново:
function Expandable({ children }) {
const [open, setOpen] = useState(false);
return (
<>
<button onClick={() => setOpen(!open)}>Toggle</button>
{open && children} {/* children не перерендериваются при каждом toggle */}
</>
);
}Слот через children против слота через props
<Modal title="Удалить?"> ← одно «главное» содержимое → children
<p>Действие нельзя отменить</p>
</Modal>
<Modal ← несколько независимых зон → именованные props
title="Удалить?"
footer={<><Button>Отмена</Button><Button variant="danger">Удалить</Button></>}
>
<p>Действие нельзя отменить</p>
</Modal>Вместо cloneElement: передать данные явно
// ✗ Старый подход: «подмешать» props в детей
function RadioGroup({ name, children }) {
return React.Children.map(children, (child) => React.cloneElement(child, { name }));
}
// ✓ Контекст: работает через любые обёртки и фрагменты
const RadioGroupContext = createContext(null);
function RadioGroup({ name, children }) {
return <RadioGroupContext value={{ name }}>{children}</RadioGroupContext>;
}
function Radio({ value, label }) {
const { name } = use(RadioGroupContext);
return <label><input type="radio" name={name} value={value} /> {label}</label>;
}Типизация
type CardProps = {
title: string;
children: React.ReactNode; // любые отображаемые узлы
footer?: React.ReactNode;
};
type DataLoaderProps<T> = {
url: string;
children: (data: T) => React.ReactNode; // function as child
};Что важно помнить
React.ChildrenиcloneElement— устаревающие API для манипуляции детьми; вместо них передавайте данные через props или контекст.- Не мутируйте и не «перебирайте»
childrenбез крайней необходимости — структура детей непредсказуема (фрагменты, условия). - В TypeScript тип —
children: React.ReactNode. - Поиск по
childrenнужного типа (child.type === Tab) ломается при обертках — используйте compound components с контекстом.
Мини-шпаргалка
children — содержимое между тегами компонента. Обертки и layout через children. Несколько слотов — обычные props с JSX. JSX — обычное значение. Тип — ReactNode.
Документация
React: Passing JSX as children, React: Children (legacy API).