React Academy · Урок

Утилиты React.Children

Безопасно изменяйте дочерние элементы с помощью React.Children.map, count и toArray

«Утилиты React.Children» — бесплатный урок React Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения React Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс React Academy содержит 4 уроков всего.

Добро пожаловать

В этом уроке Вы будете использовать вспомогательные средства React.Children — map, count, toArray и forEach, — чтобы безопасно перебирать и преобразовывать дочерние элементы независимо от их количества.

Проблема прямых методов массивов

Поскольку `props.children` может быть отдельным элементом, массивом или значением undefined, прямой вызов `.map()` приведёт к сбою. Вспомогательные средства React.Children безопасно обрабатывают все эти случаи.

// Unsafe — crashes if children is a single element
children.map(c => ...);

// Safe
React.Children.map(children, c => ...);

React.Children.map

Работает как `Array.prototype.map`, но безопасно обрабатывает один дочерний элемент, несколько дочерних элементов, а также значения null и undefined. Возвращает массив клонированных элементов или результат, возвращённый функцией обратного вызова.

function List({ children }) {
  return (
    <ul>
      {React.Children.map(children, (child, i) => (
        <li key={i}>{child}</li>
      ))}
    </ul>
  );
}

React.Children.count

`React.Children.count(children)` возвращает количество дочерних элементов: отдельный элемент правильно считается как 1, а null и undefined — как 0.

function RequiresTwo({ children }) {
  if (React.Children.count(children) !== 2) {
    throw new Error('Exactly two children required');
  }
  return <div>{children}</div>;
}

React.Children.toArray

Преобразует дочерние элементы в плоский массив со стабильными ключами. Это позволяет сортировать, фильтровать или извлекать часть дочерних элементов с помощью обычных методов массивов, не беспокоясь о вложенности.

function Reversed({ children }) {
  const arr = React.Children.toArray(children);
  return <>{arr.reverse()}</>;
}

React.Children.forEach

Подобен `.map()`, но не возвращает значение. Используйте его, когда нужно перебрать дочерние элементы ради побочных эффектов, например чтобы проверить их типы или построить таблицу поиска.

React.Children.forEach(children, child => {
  if (!React.isValidElement(child)) {
    console.warn('Non-element child found');
  }
});

React.Children.only

`React.Children.only(children)` проверяет, что существует ровно один дочерний элемент, и возвращает его. Метод выбрасывает ошибку, если дочерних элементов нет или их больше одного. Это удобно для API, требующих ровно один дочерний элемент.

function SingleChild({ children }) {
  const child = React.Children.only(children);
  return React.cloneElement(child, { 'data-wrapped': true });
}

Проверка типов дочерних элементов

Объедините `React.Children.forEach` и `React.isValidElement` с типом дочернего элемента, чтобы разрешить передачу в качестве дочерних элементов только определённых типов компонентов.

React.Children.forEach(children, child => {
  if (child.type !== TabPanel) {
    throw new Error('Only TabPanel children allowed');
  }
});

React.Children и Array.from

В React 18 и более новых версиях дочерние элементы могут быть деревом элементов React, а не обычным массивом. Всегда предпочитайте React.Children вместо Array.from, чтобы избежать особых случаев с отдельными элементами и фрагментами.

Современная альтернатива: преобразование в массив с помощью toArray

Если нужны сложные преобразования, сначала вызовите `React.Children.toArray(children)`, чтобы получить плоский массив с ключами, а затем применяйте к нему обычные методы массивов.

const items = React.Children.toArray(children);
const first = items[0];
const rest = items.slice(1);

Быстрая проверка

Какой метод React.Children безопасно обрабатывает отдельный элемент, массив и дочерние элементы null/undefined — подобно Array.map, но надёжнее?

Повторение

Используйте React.Children.map для безопасного перебора, count — для проверки количества, toArray — для работы с методами массивов, forEach — для перебора с побочными эффектами, а only — для проверки наличия ровно одного дочернего элемента.

Следующий урок: **Именованные слоты через свойства-объекты** — Вы реализуете слоты для заголовка, основного содержимого и подвала, передавая JSX через именованные свойства.

Часто задаваемые вопросы

Урок «Утилиты React.Children» бесплатный?

Да — полный текст урока «Утилиты React.Children» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс React Academy, подпишись на CoddyKit PRO. Курс React Academy содержит 4 уроков всего.

Чему я научусь в уроке «Утилиты React.Children»?

Безопасно изменяйте дочерние элементы с помощью React.Children.map, count и toArray Ты практикуешь React Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать React Academy?

Предыдущий опыт не требуется. React Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Утилиты React.Children»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке React Academy?

Да. Каждый урок React Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к React Academy