API Reference
Components

<Fragment> (<>...</>)

<Fragment>, или <>...</>, позволяет группировать элементы без тега-обертки.

<>
  <OneChild />
  <AnotherChild />
</>

Справочник

<Fragment>

Оберните элементы в <Fragment> для объединения их, когда вам нужен один элемент. Группировка элементов в Fragment не влияет на итоговый DOM; оно остаётся таким же, как если бы элементы не были сгруппированы. Пустой JSX-тег <></> обычно является сокращением для <Fragment></Fragment>.

Пропсы

  • необязательный key: Фрагменты, объявленные с помощью явного синтаксиса <Fragment>, могут иметь ключи.

Предостережения

  • Если вы хотите передать key фрагменту, то воспользоваться краткой формой <>...</> не выйдет. Вы должны явно импортировать Fragment из 'react' и рендерить <Fragment key={yourKey}>...</Fragment>.

  • React не сбрасывает состояние при переходе от рендеринга <><Child /></> к [<Child />] или обратно, или при переходе от <><Child /></> к <Child /> или обратно. Это работает только на одном уровне вложенности: например, переход от <><><Child /></></> к <Child /> сбрасывает состояние. Точную семантику можно посмотреть здесь.

Применение

Возвращение нескольких элементов

Используйте Fragment или <>...</>, чтобы сгруппировать несколько элементов. Вы можете применить его для размещения нескольких элементов в любом месте, где может находиться один элемент. Например, компонент может возвращать только один элемент, но с помощью Fragment можно сгруппировать несколько элементов вместе и затем вернуть их:

function Post() {
  return (
    <>
      <PostTitle />
      <PostBody />
    </>
  );
}

Фрагменты полезны тем, что группировка элементов с их помощью не влияет на макет или стили, в отличие от оборачивания элементов в другой контейнер, например, DOM-элемент. Изучив этот пример в браузере с помощью инструментов разработчика, вы увидите, что все DOM-узлы <h1> и <article> отображаются рядом и без обёрток:

export default function Blog() {
  return (
    <>
      <Post title="Обновление" body="Давненько я не писал..." />
      <Post title="Мой новый блог" body="Я начинаю новый блог!" />
    </>
  )
}

function Post({ title, body }) {
  return (
    <>
      <PostTitle title={title} />
      <PostBody body={body} />
    </>
  );
}

function PostTitle({ title }) {
  return <h1>{title}</h1>
}

function PostBody({ body }) {
  return (
    <article>
      <p>{body}</p>
    </article>
  );
}
Deep Dive

Как написать фрагмент без специального синтаксиса?

Приведенный выше пример эквивалентен импорту Fragment из React:

import { Fragment } from 'react';

function Post() {
  return (
    <Fragment>
      <PostTitle />
      <PostBody />
    </Fragment>
  );
}

В большинстве случаев это не нужно, за исключением ситуаций, когда необходимо передать фрагменту key.

Присвоение переменной нескольких элементов

Как и любой другой элемент, вы можете присваивать элементы Fragment переменным, передавать их в качестве пропсов и так далее:

function CloseDialog() {
  const buttons = (
    <>
      <OKButton />
      <CancelButton />
    </>
  );
  return (
    <AlertDialog buttons={buttons}>
      Вы уверены, что хотите покинуть эту страницу?
    </AlertDialog>
  );
}

Группировка элементов с текстом

Вы можете использовать Fragment для группировки текста вместе с компонентами:

function DateRangePicker({ start, end }) {
  return (
    <>
      С
      <DatePicker date={start} />
      до
      <DatePicker date={end} />
    </>
  );
}

Рендеринг списка фрагментов

Рассмотрим ситуацию, где вы должны использовать Fragment, а не его краткую форму <></>. Когда вы рендерите несколько элементов в цикле, то каждому из них нужно присвоить key. Если элементы цикла являются фрагментами, то вам необходимо использовать стандартный синтаксис JSX-элементов, чтобы это сделать:

function Blog() {
  return posts.map(post =>
    <Fragment key={post.id}>
      <PostTitle title={post.title} />
      <PostBody body={post.body} />
    </Fragment>
  );
}

Вы можете проверить DOM и убедиться, что дочерние элементы фрагмента ни во что не обернуты:

import { Fragment } from 'react';

const posts = [
  { id: 1, title: 'Обновление', body: "Давненько я не писал..." },
  { id: 2, title: 'Мой новый блог', body: 'Я начинаю новый блог!' }
];

export default function Blog() {
  return posts.map(post =>
    <Fragment key={post.id}>
      <PostTitle title={post.title} />
      <PostBody body={post.body} />
    </Fragment>
  );
}

function PostTitle({ title }) {
  return <h1>{title}</h1>
}

function PostBody({ body }) {
  return (
    <article>
      <p>{body}</p>
    </article>
  );
}
Предыдущая главаComponents
Следующая глава<Profiler>