Default Props Valores padrão de props

Última atualização: 2026-11-03

Default Props Valores padrão de props

Quando o pai não passa uma prop, o valor dela é undefined e a interface pode ficar em branco ou lançar um erro. Os valores padrão da desestruturação (ou o operador ??) dão um fallback às props opcionais, para que o componente continue se comportando de forma sensata quando uma prop falta e a interface permaneça amigável. Os defaults só entram em ação quando o valor é undefined, então valores falsy como 0 ou string vazia continuam sendo respeitados.

GrupoRenderização e Estado
TipoPadrão
DesdePrimeiras versões do React

ℹ️ Informação O editor transpila JSX para JavaScript e renderiza a UI real na sandbox; os componentes são montados automaticamente — sem render manual.

📝 Sintaxe

function Avatar({ name = 'Anonymous', size = 40 }) {
//                    ↑ default de desestruturação: aplicado quando a prop não é passada
  ...
}

⚙️ Parâmetros

destructuring defaultDê um fallback a uma prop com = dentro da desestruturação do parâmetro; ele só se aplica quando o valor é undefined, então 0 e '' continuam sendo usados como vieram.

Retorna:Sem valor de retorno — uma convenção de código e um modelo mental.

▶ Exemplo

O exemplo roda direto: renderiza automaticamente ao expandir e edições valem na hora.

Saída:

Três linhas de avatares: a primeira mostra uma "Alice" grande; a segunda mostra "Bob", que não tem prop de tamanho e usa o tamanho médio padrão; a terceira não passa nada e mostra o nome padrão "Anonymous user" com um avatar médio.

💡 Pontos-chave

💡 Dica Prefira os defaults de desestruturação ao antigo defaultProps, que está obsoleto: a sintaxe é mais compacta e mais amigável para a inferência de tipos.
ℹ️ Informação Cuidado com o ||, que também trata 0 e '' como "não passado"; use ?? quando o valor opcional puder ser falsy de legitimidade.
⚠️ Aviso Não dê valor padrão a props obrigatórias: é melhor marcá-las como obrigatórias no TypeScript ou avisar claramente durante o desenvolvimento.
Mais casos em breve.

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

P Ainda posso usar defaultProps?
R Ele está obsoleto em componentes de função e não é mais suportado desde o React 19; migre para um default de desestruturação na lista de parâmetros, que significa a mesma coisa e fica mais legível.
P Como defino um valor padrão para uma prop?
R A forma mais comum é o default de desestruturação, function C({ size = 40 }); você também pode escrever const size = props.size ?? 40 dentro do corpo da função.
P Qual a diferença entre || e ?? para defaults?
R O || também cai no default para 0, '' e false, enquanto o ?? só cai para null e undefined. Prefira ?? para números e strings opcionais.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%