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

Почему соседние 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.

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

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

Поиск

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