Почему соседние JSX-элементы нужно объединять
На этой странице
Соседние JSX-теги нужно объединить в одно JavaScript-выражение, потому что JSX компилируется в вызов функции (jsx("h1", ...)), а функция или return возвращают одно значение. Два вызова подряд без объединения — синтаксическая ошибка сборки. Объединить можно фрагментом <>...</> (не добавляет узел в DOM), смысловым элементом (<section>, <ul>), если он нужен для разметки и стилей, или массивом элементов с key. Это ограничение синтаксиса, а не требование «один DOM-узел на компонент»: компонент может отрендерить сколько угодно соседних узлов.
Вопрос
Почему нельзя написать два соседних тега после return? Обязательно ли создавать общий div?
Причина: JSX — это вызов функции
// Что написал разработчик
return (
<h1>Заголовок</h1>
<p>Текст</p>
);// Во что это должно было бы скомпилироваться
return (
jsx("h1", { children: "Заголовок" })
jsx("p", { children: "Текст" }) // ✗ два выражения подряд — синтаксическая ошибка JS
);Так же нельзя написать return 1 2;. Компилятор JSX сообщает: «Adjacent JSX elements must be wrapped in an enclosing tag».
Не объясняй ошибку через оператор «запятая»: соседние JSX-теги в него не превращаются. Если вручную написать return (a, b), JavaScript вернёт только b — это другой (и тоже неправильный) код.
Способ 1: Fragment — группировка без лишнего узла
export default function AboutCourse() {
return (
<>
<h1>Подготовка к собеседованию</h1>
<p>Разбираем React на примерах.</p>
</>
);
}<!-- Итоговый DOM: без обёртки -->
<h1>Подготовка к собеседованию</h1>
<p>Разбираем React на примерах.</p>Способ 2: смысловой контейнер
function CourseSection() {
return (
<section className="course" aria-labelledby="course-title">
<h2 id="course-title">React</h2>
<p>Компоненты, состояние и хуки.</p>
</section>
);
}Используй обёртку, когда у группы есть смысл (section, article, nav, ul) или нужны стили контейнера.
Способ 3: массив
function ShortFacts() {
return [
<p key="components">UI состоит из компонентов.</p>,
<p key="state">State хранит изменяемые данные.</p>,
];
}Каждому элементу массива нужен устойчивый key. На практике массивы возвращают редко — чаще используют map внутри фрагмента.
Почему лишний div вредит
// Таблица: div внутри <tr> — невалидная разметка, браузер «перестроит» DOM
function Cells({ row }) {
return (
<div> {/* ✗ */}
<td>{row.name}</td>
<td>{row.price}</td>
</div>
);
}
// ✓ Fragment сохраняет структуру <tr><td/><td/></tr>
function Cells({ row }) {
return (
<>
<td>{row.name}</td>
<td>{row.price}</td>
</>
);
}Где лишний div ломает | Что происходит |
|---|---|
<table>, <tr> | Невалидный HTML, браузер переносит узлы, ошибки гидратации при SSR |
<ul>, <ol> | Скринридер перестаёт видеть список («список, 3 элемента») |
| Flex / Grid | Дети div перестают быть flex/grid-элементами родителя — раскладка ломается |
<dl>, <select> | Нарушается допустимая структура |
Fragment с key
Короткая запись <> не принимает атрибуты. Если фрагменты создаются в map, используй полную форму:
import { Fragment } from "react";
function Glossary({ terms }) {
return (
<dl>
{terms.map((term) => (
<Fragment key={term.id}>
<dt>{term.word}</dt>
<dd>{term.definition}</dd>
</Fragment>
))}
</dl>
);
}Как выбрать
У группы есть смысл в HTML или нужны стили контейнера?
├─ Да → смысловой элемент (section, ul, nav, article…)
└─ Нет → Fragment (<>…</> или <Fragment key> в списках)Что важно помнить
- Ограничение — синтаксическое: функция возвращает одно значение.
- Fragment группирует элементы без DOM-узла.
- Лишние обёртки ломают таблицы, списки, flex и grid, а при SSR — гидратацию.
- В
mapнужен<Fragment key>, короткая форма<>ключ не принимает.
Мини-шпаргалка
- Соседние теги без объединения — ошибка сборки.
<>…</>— без лишнего узла;<Fragment key>— в списках.- Обёртка-элемент — только если нужна по смыслу или для стилей.
- Массив элементов тоже допустим, но с
key.