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

Что делает React.Fragment

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

Fragment группирует несколько React-узлов в одно значение, не добавляя элемент в DOM. Нужен, когда компонент возвращает несколько соседних элементов, а обёртка нарушила бы разметку или стили: ячейки таблицы, пары dt/dd, элементы flex- и grid-контейнеров. Короткая запись <>…</> не принимает атрибуты; полная <Fragment key={id}> нужна, когда фрагменты создаются в списке. С React 19.3 у полного Fragment может быть ещё и ref — он даёт доступ к DOM-детям группы (фокус, наблюдатели, измерения).

Вопрос

Для чего нужен Fragment, чем отличаются полная и короткая записи и когда нужен key?

Проблема: обёртка ломает разметку

// ✗ div внутри <tr> — невалидный HTML
function UserCells({ name, score }) {
  return (
    <div>
      <td>{name}</td>
      <td>{score}</td>
    </div>
  );
}

Браузер «исправит» такую таблицу, переставив узлы, — React потеряет соответствие с DOM, а при SSR получишь ошибку гидратации. Нужно вернуть две ячейки без контейнера.

Решение: Fragment

function UserCells({ name, score }) {
  return (
    <>
      <td>{name}</td>
      <td>{score}</td>
    </>
  );
}
 
export default function Results() {
  return (
    <table>
      <caption>Результаты тренировки</caption>
      <tbody>
        <tr><UserCells name="Анна" score={8} /></tr>
      </tbody>
    </table>
  );
}
Дерево React:                     DOM:
<tr>                              <tr>
 └─ <UserCells>                    ├─ <td>Анна</td>
     └─ Fragment                   └─ <td>8</td>
         ├─ <td>                  </tr>
         └─ <td>

Fragment существует в дереве React (участвует в сравнении детей), но не в DOM.

Короткая и полная запись

ЗаписьАтрибутыКогда
<>…</>НетОбычная группировка
<Fragment>…</Fragment>key, ref (19.3+)Списки, доступ к детям

Fragment с key в списке

import { Fragment } from "react";
 
const terms = [
  { id: "props", title: "Props", description: "Входные данные компонента" },
  { id: "state", title: "State", description: "Память компонента" },
];
 
function Glossary() {
  return (
    <dl>
      {terms.map((term) => (
        <Fragment key={term.id}>
          <dt>{term.title}</dt>
          <dd>{term.description}</dd>
        </Fragment>
      ))}
    </dl>
  );
}

key относится ко всей паре dt + dd: при сортировке или удалении React переместит группу целиком.

Fragment с ref (React 19.3)

import { Fragment, useEffect, useRef } from "react";
 
function Results({ items }) {
  const groupRef = useRef(null);
 
  useEffect(() => {
    groupRef.current.focus(); // фокус на первый фокусируемый элемент среди детей
  }, [items]);
 
  return (
    <Fragment ref={groupRef}>
      {items.map((item) => <a key={item.id} href={item.url}>{item.title}</a>)}
    </Fragment>
  );
}

Раньше ради этого приходилось добавлять обёрточный div и ломать раскладку.

Где Fragment особенно полезен

МестоПочему обёртка мешает
<table>, <tr>, <tbody>Допустимы только определённые дети
<ul>, <ol>, <dl>Ломается семантика списка для скринридеров
Flex / Grid-контейнерДети обёртки перестают быть flex/grid-элементами
Компонент «условно добавляет пару элементов»Лишний узел меняет стили соседей (:first-child, gap)

Когда нужен не Fragment, а элемент

Fragment не принимает className, style, обработчики событий и не создаёт область для стилей. Если группе нужен фон, отступ, aria-label или она по смыслу — раздел, навигация, карточка, — используй <section>, <nav>, <article>.

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

  • Fragment группирует элементы без DOM-узла, но участвует в дереве React.
  • <> — без атрибутов; <Fragment key> — в списках.
  • Внутри таблиц, списков, flex и grid лишняя обёртка ломает разметку и раскладку.
  • Для стилей и семантики нужен настоящий элемент.

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

  • <>…</> — короткая запись.
  • <Fragment key={id}> — группа в map.
  • <Fragment ref={ref}> — доступ к детям (19.3+).
  • Нужны стили/смысл → section, article, nav.

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

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

Поиск

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