We want to hear from you!Take our 2021 Community Survey!
Este site não é mais atualizado.Vá para pt-br.react.dev

Fragmentos

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React:

Um padrão comum no React é que um componente pode retornar múltiplos elementos. Os Fragmentos permitem agrupar uma lista de filhos sem adicionar nós extras ao DOM.

render() {
  return (
    <React.Fragment>
      <ChildA />
      <ChildB />
      <ChildC />
    </React.Fragment>
  );
}

Há também uma nova sintaxe curta para declará-las.

Motivação

Um padrão comum é para um componente retornar uma lista de filhos. Considerando o código React a seguir:

class Table extends React.Component {
  render() {
    return (
      <table>
        <tr>
          <Columns />
        </tr>
      </table>
    );
  }
}

<Columns /> precisaria retornar múltiplos elementos <td> para que o HTML renderizado fosse válido. Se um div pai for usado dentro do render() de <Columns />, então o HTML resultante será inválido.

class Columns extends React.Component {
  render() {
    return (
      <div>
        <td>Hello</td>
        <td>World</td>
      </div>
    );
  }
}

Resulta na seguinte <Table />:

<table>
  <tr>
    <div>
      <td>Hello</td>
      <td>World</td>
    </div>
  </tr>
</table>

Os Fragmentos resolvem este problema.

Uso

class Columns extends React.Component {
  render() {
    return (
      <React.Fragment>        <td>Hello</td>
        <td>World</td>
      </React.Fragment>    );
  }
}

que resulta em uma <Table /> correta:

<table>
  <tr>
    <td>Hello</td>
    <td>World</td>
  </tr>
</table>

Sintaxe curta

Existe uma sintaxe nova e mais curta que você pode usar para declarar fragmentos. Parecem tags vazias:

class Columns extends React.Component {
  render() {
    return (
      <>        <td>Hello</td>
        <td>World</td>
      </>    );
  }
}

Você pode usar <></> da mesma forma que você usaria qualquer outro elemento, exceto que ele não suporta chaves ou atributos.

Fragmentos com chaves

Fragmentos declarados com <React.Fragment> podem ter chaves. Um caso de uso para isso é mapear uma coleção para um array de fragmentos - por exemplo, para criar uma lista de descrição:

function Glossary(props) {
  return (
    <dl>
      {props.items.map(item => (
        // Sem a `key`, React irá disparar um aviso
        <React.Fragment key={item.id}>
          <dt>{item.term}</dt>
          <dd>{item.description}</dd>
        </React.Fragment>
      ))}
    </dl>
  );
}

key é o único atributo que pode ser passado para o Fragment. No futuro, podemos adicionar suporte para outros atributos, como manipuladores de eventos.

Demonstração ao vivo

Você pode experimentar a nova sintaxe de fragmento JSX com este CodePen.

Esta página é útil?Edite esta página