API de Referência
Componentes

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

<Fragment>, frequentemente usado por meio da sintaxe <>...</>, permite agrupar elementos sem um nó de encapsulamento.

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

Referência

<Fragment>

Encapsule elementos em <Fragment> para agrupá-los juntos em situações em que você precisa de um único elemento. Agrupar elementos em Fragment não afeta o DOM resultante; é o mesmo que se os elementos não estivessem agrupados. A tag JSX vazia <></> é uma forma abreviada de <Fragment></Fragment> na maioria dos casos.

Props

  • opcional key: Fragments declarados com a sintaxe explícita <Fragment> podem ter keys..

Cuidados

  • Se você quiser passar uma key para um Fragment, não pode usar a sintaxe <>...</>. Você precisa importar explicitamente o Fragment de 'react' e renderizar <Fragment key={suaChave}>...</Fragment>.

  • O React não reseta o estado quando você passa de <><Child /></> para [<Child />] ou vice-versa, ou quando você passa de <><Child /></> para <Child /> e vice-versa. Isso funciona apenas para um único nível: por exemplo, passar de <><><Child /></></> para <Child /> reseta o estado. Veja a semântica precisa aqui..

Uso

Retornando múltiplos elementos

Use Fragment ou a sintaxe equivalente <>...</> para agrupar vários elementos juntos. Você pode usá-lo para colocar vários elementos em qualquer lugar onde um único elemento possa ir. Por exemplo, um componente só pode retornar um elemento, mas usando um Fragment você pode agrupar vários elementos juntos e então retorná-los como um grupo:

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

Fragments são úteis porque agrupar elementos com um Fragment não afeta o layout ou os estilos, ao contrário se você envolvesse os elementos em outro container como um elemento do DOM. Se você inspecionar este exemplo com as ferramentas do navegador, verá que todos os nós do DOM <h1> e <article> aparecem como irmãos sem encapsulamento ao redor deles:

export default function Blog() {
  return (
    <>
      <Post title="Uma atualização" body="Faz um tempo desde que eu publiquei..." />
      <Post title="Meu novo blog" body="Eu estou começando um novo blog!" />
    </>
  )
}

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

Como escrever um Fragment sem a sintaxe especial?

O exemplo acima é equivalente a importar Fragment do React:

import { Fragment } from 'react';

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

Normalmente, você não precisará disso, a menos que precise passar uma key para o seu Fragment.

Atribuindo vários elementos a uma variável

Assim como qualquer outro elemento, você pode atribuir elementos de Fragment a variáveis, passá-los como props, e assim por diante:

function CloseDialog() {
  const buttons = (
    <>
      <OKButton />
      <CancelButton />
    </>
  );
  return (
    <AlertDialog buttons={buttons}>
      Você tem certeza que deseja sair desta página?
    </AlertDialog>
  );
}

Agrupando elementos com texto

Você pode usar Fragment para agrupar textos juntamente com componentes:

function DateRangePicker({ start, end }) {
  return (
    <>
      De
      <DatePicker date={start} />
      para
      <DatePicker date={end} />
    </>
  );
}

Renderizando uma lista de Fragments

Aqui está uma situação em que você precisa escrever Fragment explicitamente em vez de usar a sintaxe <></>. Quando você renderiza vários elementos em um loop, é necessário atribuir uma key a cada elemento. Se os elementos dentro do loop forem Fragments, você precisará usar a sintaxe normal de elementos JSX para fornecer o atributo key:

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

Você pode inspecionar o DOM para verificar que não há elementos de encapsulamento ao redor dos filhos do Fragment:

import { Fragment } from 'react';

const posts = [
  { id: 1, title: 'Uma atualização', body: "Faz um tempo desde que eu publiquei..." },
  { id: 2, title: 'Meu novo blog', body: 'Eu estou começando um novo blog!' }
];

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>
  );
}
PreviousComponentes
Next<Profiler>