Lifting State Up no React: Elevando o Estado Compartilhado & Callbacks
📑 Índice do Conteúdo
1. O Dilema da Comunicação Entre Componentes Irmãos
No modelo arquitetural do React, os dados trafegam de maneira estritamente unidirecional: de cima para baixo (Top-Down Data Flow), fluindo dos componentes pais em direção aos filhos através de propriedades (props). Esse modelo garante previsibilidade e simplicidade de raciocínio.
No entanto, em aplicações reais frequentemente nos deparamos com o seguinte desafio:
“Como dois ou mais componentes que estão no mesmo nível hierárquico (irmãos) podem compartilhar e sincronizar os mesmos dados em tempo real, se eles não podem conversar lateralmente entre si?”
Considere o clássico exemplo de um conversor de temperaturas ou de moedas: temos o componente <InputCelsius /> e o componente <InputFahrenheit />. Se cada um mantiver seu próprio useState isolado internamente, eles ficarão permanentemente dessincronizados, duplicando dados e gerando inconsistências visuais inaceitáveis.
2. O Padrão Arquitetural: Lifting State Up (Elevação de Estado)
A solução oficial recomendada pela equipe do React para esse problema é o padrão Lifting State Up (Elevar o Estado). A regra de ouro é:
Princípio da Elevação de Estado
Se dois ou mais componentes filhos precisam acessar ou modificar o mesmo dado, remova o estado de dentro deles e eleve-o para o ancestral comum mais próximo (Closest Common Ancestor).
O componente pai se torna a Única Fonte da Verdade (Single Source of Truth), e os filhos passam a ser componentes controlados e puros.
3. A Mecânica da Comunicação: Props para Baixo, Callbacks para Cima
Para implementar o Lifting State Up com maestria, dividimos o fluxo de comunicação em duas vias bem delimitadas:
- Do Pai para o Filho (Top-Down): O componente ancestral repassa o valor atual do estado através de uma
propde leitura comum. - Do Filho para o Pai (Bottom-Up): O componente ancestral repassa também uma Função de Callback (como
onTemperaturaChange). Quando o usuário digita no input do filho, ele invoca esse callback repassando o novo valor para o pai, que finalmente executa osetStatee repinta toda a sub-árvore de componentes!
Topologia de Comunicação em Árvore
┌─────────────────────────────────────────┐
│ <CalculadoraTemperatura /> │
│ const [temperatura, setTemperatura] │
└────────────────────┬────────────────────┘
│
┌───────────────────────┴───────────────────────┐
│ │
▼ ▼
┌─────────────────────────────┐ ┌─────────────────────────────┐
│ <InputCelsius /> │ │ <InputFahrenheit /> │
│ • prop: valor │ │ • prop: valor │
│ • callback: onChange │ │ • callback: onChange │
└─────────────────────────────┘ └─────────────────────────────┘
4. Implementação Prática Passo a Passo
Veja a elegância do código de um conversor de moedas sincronizado:
jsx
// O filho não tem useState! Ele apenas reflete 'valor' e dispara 'onValorChange'
function CampoMoeda({ moeda, valor, onValorChange }) {
return (
<div className="campo-moeda">
<label>{moeda}:</label>
<input
type="number"
value={valor}
onChange={e => onValorChange(e.target.value)}
placeholder="0.00"
/>
</div>
);
}
jsx
function ConversorUniversal() {
// O estado reside EXCLUSIVAMENTE aqui no topo:
const [cotacao, setCotacao] = useState({ valorBrl: 100, moedaOrigem: 'BRL' });
const cotacaoDolar = 5.20; // 1 USD = 5.20 BRL
const handleBrlChange = (novoBrl) => {
setCotacao({ valorBrl: novoBrl, moedaOrigem: 'BRL' });
};
const handleUsdChange = (novoUsd) => {
setCotacao({ valorBrl: novoUsd * cotacaoDolar, moedaOrigem: 'USD' });
};
const valorBrl = cotacao.valorBrl;
const valorUsd = (valorBrl / cotacaoDolar).toFixed(2);
return (
<div className="conversor">
<CampoMoeda moeda="Real (BRL)" valor={valorBrl} onValorChange={handleBrlChange} />
<CampoMoeda moeda="Dólar (USD)" valor={valorUsd} onValorChange={handleUsdChange} />
</div>
);
}
5. Limites do Lifting State Up: Quando Subir Demais é Prejudicial?
O Lifting State Up é a ferramenta padrão e obrigatória para componentes que compartilham estado e estão relativamente próximos na árvore de componentes.
No entanto, se você precisar elevar o estado para um ancestral localizado a 5 ou 6 níveis de distância, você acabará caindo novamente no problema do Prop Drilling (estudado na Lição 10), repassando propriedades por componentes intermediários que não têm nenhum interesse nelas.
Essa fronteira arquitetural marca a transição ideal para os módulos subsequentes do curso:
- Para estados compartilhados entre irmãos imediatos ou com poucos níveis de distância: use Lifting State Up.
- Para estados transversais globais (autenticação de usuário, carrinho de compras, idioma global): utilizaremos a Context API e Custom Hooks (Módulo 4).
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