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

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).

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

Поиск

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