Renderização de Listas no React: map e a Regra das Keys
⚡ Curso de React.js • Web-ZoneWare

Renderização de Listas no React: map() e a Regra de Ouro das Keys

Lição 5 de 50

Renderização de Listas no React: map() e a Regra de Ouro das Keys

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:

CODE 18 linhas
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:

  1. O novo item inserido assume o key={0}.
  2. O item que antes era o índice 0 passa a ser key={1}.
  3. O React compara as árvores antigas e novas e pensa: “O elemento na posição 0 continua existindo, apenas suas propriedades mudaram!”
  4. 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, uuid ou 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 do map() (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.

🛠️ Laboratório Prático & Prática Imediata

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.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground 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
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima