Eventos no React: SyntheticEvent e Delegação
⚡ Curso de React.js • Web-ZoneWare

Manipulação de Eventos no React: SyntheticEvent, Delegação & Pooling

Lição 15 de 50

Manipulação de Eventos no React: SyntheticEvent, Delegação & Pooling

1. O Sistema de Eventos do React: Muito Além do DOM Nativo

No desenvolvimento web tradicional com JavaScript puro, escutamos eventos anexando ouvintes diretamente aos elementos do DOM via element.addEventListener('click', handler). Embora simples, essa abordagem direta apresenta dois grandes gargalos quando escalada para aplicações ricas e de grande porte:

  1. Inconsistências Cross-Browser: Diferentes navegadores e versões históricas (Safari, Firefox, Chrome, Edge) possuem nuances e pequenas divergências em como representam propriedades de eventos, coordenadas de mouse e eventos de teclado.
  2. Consumo Excessivo de Memória: Se você renderiza uma tabela com 1.000 linhas e cada uma contém botões com seus próprios addEventListener, o navegador precisará alocar milhares de manipuladores na memória, degradando a fluidez da página.

Para resolver esses dois problemas de uma só vez, o React implementou uma arquitetura proprietária e ultra-otimizada baseada em dois pilares:

  • O SyntheticEvent (uma camada de normalização de eventos de acordo com o padrão W3C).
  • A Delegação de Eventos na Raiz (Event Delegation no nó container).

2. Anatomia do SyntheticEvent

Sempre que você declara um manipulador de evento no JSX (como onClick={handleClick}), a função que você passa como callback recebe um único argumento: um objeto SyntheticEvent.

CODE 14 linhas
function BotaoAlerta() {
  function handleClick(e) {
    // 'e' NÃO É o MouseEvent puro do navegador!
    // É uma instância de SyntheticEvent do React.
    console.log("Tipo do evento:", e.type); // ___WZW_STR_1___
    console.log("Elemento clicado:", e.target);
    console.log("Elemento com o handler:", e.currentTarget);
    
    // Se você precisar acessar o evento nativo bruto por algum motivo:
    console.log("Evento nativo subjacente:", e.nativeEvent);
  }
 
  return <button onClick={handleClick}>Clique Aqui</button>;
}

O SyntheticEvent implementa rigorosamente a interface padrão de eventos da W3C. Isso significa que você tem acesso garantido a todas as propriedades e métodos universais, como e.target, e.currentTarget, e.clientX, e.key, e.preventDefault() e e.stopPropagation(), com a certeza matemática de que o código se comportará de maneira idêntica em qualquer navegador moderno.

⚠️ Duas Diferenças Sintáticas Vitais em Relação ao HTML:

1. Nomenclatura em camelCase: No HTML clássico escreve-se onclick, onchange, onsubmit. No React, os nomes são sempre estritamente em camelCase: onClick, onChange, onSubmit, onKeyDown.

2. Funções e não Strings: No HTML você passava uma string executável (onclick="salvar()"). No React, você passa uma referência direta a uma função (onClick={salvar}). Nunca chame a função com parênteses imediatos no JSX (onClick={salvar()}), a menos que queira executá-la durante a renderização!


3. Delegação de Eventos na Raiz (Event Delegation)

Esta é uma das maiores genialidades de performance do React. Quando você escreve:

CODE 12 linhas
function ListaProdutos({ itens }) {
  return (
    <ul>
      {itens.map(item => (
        <li key={item.id}>
          {item.nome}
          <button onClick={() => comprar(item.id)}>Comprar</button>
        </li>
      ))}
    </ul>
  );
}

Se a lista contiver 5.000 itens, o React NÃO adiciona 5.000 ouvintes de clique aos botões no DOM. Em vez disso, o React anexa apenas um ouvinte centralizado no container raiz da aplicação (o nó #root):

O Ciclo de Borbulhamento até o Root Container

[ Clique no <button> ]
        │
        ▼ (Event Bubbling nativo)
   <li> ───> <ul> ───> <main> ───> [ div id="root" ]
                                           │
                                           ▼ (React Event Dispatcher)
   O React intercepta o evento na raiz, descobre qual nó disparou e executa seu handler!
    

Graças a essa arquitetura, a pegada de memória da sua aplicação permanece ultraleve, e a inserção ou destruição dinâmica de elementos na tela não exige criar ou remover listeners continuamente.


4. O Fim Definitivo do Event Pooling no React 17+

Se você consultar tutorias antigos do React (anteriores ao React 17), encontrará alertas enfáticos sobre o Event Pooling:

“No React 16 e anteriores, para economizar memória, os objetos SyntheticEvent eram reciclados após a execução do handler. Suas propriedades eram todas limpas para null. Se você tentasse ler e.target.value dentro de um setTimeout ou de uma Promise, recebia null, sendo obrigado a chamar e.persist().”

A Boa Notícia Moderna: No React 17 e React 18, o Event Pooling foi completamente removido! Os navegadores modernos evoluíram tanto em otimização de coleta de lixo (Garbage Collection) que o pool de eventos deixou de trazer ganhos perceptíveis. Hoje em dia, o objeto de evento permanece íntegro na memória e você pode usá-lo livremente dentro de callbacks assíncronos:

CODE 13 linhas
// ✅ PERFEITAMENTE VÁLIDO NO REACT 17 E 18:
function InputBusca() {
  function handleChange(e) {
    const texto = e.target.value;
    setTimeout(() => {
      // No React 16 isso falhava (e.target era null)!
      // No React 18 funciona com 100% de estabilidade:
      console.log("Texto buscado com delay:", e.target.value);
    }, 1000);
  }
 
  return <input onChange={handleChange} placeholder="Buscar..." />;
}

5. Controle de Propagação e Prevenção de Padrão

Dois métodos do SyntheticEvent que você usará diariamente:

  • e.preventDefault(): Cancela o comportamento nativo que o navegador executaria por padrão. É obrigatório ao lidar com formulários (para impedir que a página recarregue ao submeter) e com links <a> que funcionam como botões de ação. Nota: no React, retornar false no corpo da função NÃO cancela o evento. Você DEVE invocar e.preventDefault() explicitamente!
  • e.stopPropagation(): Interrompe a propagação do evento pela árvore do DOM, impedindo que os nós pais recebam o evento borbulhado (bubbling).
🛠️ 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