Renderização de Listas no React: map() e a Regra de Ouro das Keys
📑 Índice do Conteúdo
1. A Transformação Funcional de Dados em Telas
A exibição de listas dinâmicas de dados (como feeds de redes sociais, catálogos de e-commerce ou tabelas financeiras) é uma das operações mais corriqueiras no desenvolvimento web. Enquanto outros frameworks recorrem a diretivas especiais de iteração (como *ngFor ou v-for), o React adota a elegância do paradigma funcional do JavaScript com o método Array.prototype.map().
O método map() percorre cada item de um array e retorna um novo array contendo elementos JSX, que o React renderiza na interface de forma declarativa e automática:
const products = [
{ id: 'p1', name: 'Teclado Mecânico RGB', price: 349.90 },
{ id: 'p2', name: 'Mouse Sem Fio 16000 DPI', price: 199.00 },
{ id: 'p3', name: 'Monitor UltraWide 29"', price: 1290.00 }
];
function ProductList() {
return (
<ul className="product-list">
{products.map(product => (
<li key={product.id} className="product-item">
<span>{product.name}</span>
<strong>R$ {product.price.toFixed(2)}</strong>
</li>
))}
</ul>
);
}
2. Por Que o React Exige a Propriedade `key`?
Quando você renderiza uma lista no React sem fornecer a propriedade key, o console do navegador emite imediatamente um alerta de aviso: “Warning: Each child in a list should have a unique ‘key’ prop.”
Esse aviso não é estético: ele é vital para a performance e a integridade dos dados da sua aplicação. A propriedade key fornece uma identidade estável única a cada elemento entre renderizações consecutivas. É graças a ela que o algoritmo de reconciliação (Diffing Algorithm) do Virtual DOM sabe exatamente:
Como as Keys Orientam o Algoritmo de Diffing
- Qual item foi adicionado: Inserir apenas o novo nó no DOM sem recriar os demais.
- Qual item foi removido: Desmontar cirurgicamente apenas o nó excluído.
- Qual item mudou de posição: Apenas reordenar nós existentes no DOM físico (via
insertBefore) em vez de destruir e reconstruir a lista inteira.
3. O Anti-Padrão Perigoso: Por Que NUNCA Usar `key={index}`
Muitos desenvolvedores iniciantes, ao se depararem com o alerta do React, tentam “silenciá-lo” rapidamente utilizando o índice numérico da iteração:
🚨 O Perigo do Índice como Key
// ❌ NUNCA FAÇA ISSO EM LISTAS MUTÁVEIS:
{items.map((item, index) => (
<TodoItem key={index} data={item} />
))}
Usar o index como key funciona apenas se a lista for 100% estática (nunca filtrada, reordenada ou com adições/exclusões). Se você inserir um item no início da lista ou reordená-la:
- O novo item inserido assume o
key={0}. - O item que antes era o índice 0 passa a ser
key={1}. - O React compara as árvores antigas e novas e pensa: “O elemento na posição 0 continua existindo, apenas suas propriedades mudaram!”
- O desastre acontece: Se os componentes da lista possuírem estado interno local (como inputs com texto digitado, checkboxes marcados ou animações ativas), o estado do item anterior permanecerá preso no novo item, causando bugs visuais bizarros e de difícil depuração!
4. O Que Constitui uma Key Ideal e Estável?
- Identificadores Únicos do Banco de Dados: Use sempre
item.id,uuidou o identificador primário retornado pela API. - Geração Única na Criação do Dado: Se você estiver criando novos itens localmente no estado da aplicação, gere o ID uma única vez no momento da criação (utilizando
crypto.randomUUID()), nunca gerando IDs dinâmicos dentro do JSX domap()(pois a cada re-render um novo ID seria criado, forçando a desmontagem e reconstrução completa de todos os nós).
5. Conclusão
A manipulação correta de listas com map() e identificadores estáveis é um dos pilares da alta performance no React. Garantir que cada elemento possua uma identidade persistente preserva o estado dos componentes e permite que o Virtual DOM opere com velocidade máxima.
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE