Что делает 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.