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.