Props no React: Desestruturação, Valores Padrão & A Propriedade Especial children
📑 Índice do Conteúdo
1. O Mecanismo de Comunicação entre Componentes
No React, interfaces ricas são construídas pela união de dezenas de pequenos componentes isolados. Para que esses blocos cooperem entre si, eles precisam de uma via expressa para troca de dados. Essa via é formada pelas Props (Propriedades).
Assim como uma tag nativa do HTML aceita atributos (por exemplo, <a href="..." target="...">), qualquer componente React pode receber propriedades personalizadas passadas pelo componente pai:
// Componente Pai passando props:
function App() {
return (
<div className="container">
<UserBadge name="Gabriel Monteiro" role="Engenheiro Front-End" level={5} />
</div>
);
}
Regra Sagrada do React: Props São Imutáveis (Read-Only)
Um componente jamais deve modificar diretamente suas próprias props. Trate as props como parâmetros estritamente de leitura. Se um componente precisa alterar valores que afetam sua renderização ao longo do tempo, esses valores devem pertencer ao seu Estado (State), assunto fundamental que inauguraremos no Módulo 2.
2. Padrões Modernos com Desestruturação do ES6
A assinatura de um componente funcional recebe um único argumento: o objeto props. No entanto, acessar propriedades repetidamente com props.name, props.role e props.level torna o código excessivamente verboso.
O padrão adotado por 100% dos projetos modernos é a desestruturação direta na lista de parâmetros da função, combinada com valores padrão (default values):
// ✅ Padrão Sênior: Desestruturação limpa com valores padrão
function Button({ variant = 'primary', size = 'md', label, onClick }) {
return (
<button className={`btn btn-${variant} btn-${size}`} onClick={onClick}>
{label}
</button>
);
}
O Operador Rest/Spread para Encaminhamento de Atributos
Ao criar componentes de formulário ou botões customizados que precisam aceitar qualquer atributo nativo do HTML (como disabled, id, type, aria-label), utilizamos o operador rest:
function CustomInput({ label, id, ...restProps }) {
return (
<div className="form-group">
<label htmlFor={id}>{label}</label>
<input id={id} className="form-control" {...restProps} />
</div>
);
}
3. A Propriedade Especial `children`: O Segredo da Composição
Nem sempre você sabe com antecedência quais elementos um componente precisará conter internamente. Imagine criar uma caixa de diálogo modal, um card flexível ou uma barra lateral: eles precisam funcionar como contêineres genéricos que recebem qualquer conteúdo arbitrário.
Para isso, o React reserva uma propriedade mágica e automática chamada children. Todo JSX posicionado entre a tag de abertura e a tag de fechamento de um componente é entregue a ele através dessa prop:
// 1. O componente Contêiner:
function CardBox({ title, children }) {
return (
<article className="card-box">
<header className="card-box-header">
<h4>{title}</h4>
</header>
<div className="card-box-body">
{children}
</div>
</article>
);
}
// 2. Utilização flexível (Composição pura):
function Dashboard() {
return (
<CardBox title="Métricas de Vendas">
<p>Faturamento deste mês: <strong>R$ 48.500,00</strong></p>
<button className="btn-details">Ver Relatório Completo</button>
</CardBox>
);
}
4. Passagem de Funções via Props (Comunicação Filho -> Pai)
Como o fluxo de dados no React é estritamente unidirecional (do pai para o filho), a maneira como um filho notifica o pai sobre uma ação (como um clique em um botão de exclusão ou envio de formulário) é recebendo uma função de callback via prop:
function DeleteButton({ onDelete, itemName }) {
return (
<button onClick={() => onDelete(itemName)} className="btn-danger">
Excluir {itemName}
</button>
);
}
5. Conclusão do Módulo 1
Parabéns por concluir o Módulo 1: Fundamentos do React, JSX & Componentes Funcionais! Você dominou a filosofia declarativa, a sintaxe JSX, a pureza das funções de componentes, o controle condicional de fluxo, a renderização eficiente de listas com chaves estáveis, a eliminação da Div Soup com fragmentos, os paradigmas de estilização moderna e a troca de dados através de props e composição.
No Módulo 2, mergulharemos no coração dinâmico das aplicações React: o gerenciamento de estado local com o hook useState, eventos sintéticos e o levantamento de estado (Lifting State Up).
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