mergeProps() Mesclar objetos de props

Última atualização: 2026-10-22

mergeProps() Mesclar objetos de props

mergeProps() mescla objetos de props — class e style são concatenadas, todos os listeners são preservados e, nos demais valores, o último vence.

GrupoFunções de Renderização e SSR
TipoAPI
EscopoNo Componente
Versão do Vue3.0+
Suporte a SSRSim

📝 Sintaxe

mergeProps(baseProps, { class: "extra", onClick: fn })

⚙️ Argumentos

...argsDois ou mais objetos de props

Retorno:Um objeto mesclado

▶ Exemplo

Edite o código abaixo e veja o resultado ao vivo:

Saída:

Shows 'a b / id=two'.

💡 Pontos-chave

ℹ️ Nota Comum em higher-order components que mesclam props locais e herdados.
💡 Dica Ele segue as regras do Vue para class, style e listeners.
⚠️ Aviso A mesclagem é rasa — objetos aninhados não são percorridos.
Mais casos em breve.

📚 Tutoriais Relacionados

❓ FAQ

P Qual a diferença em relação a Object.assign?
R assign sobrescreve as classes; mergeProps segue a semântica do Vue.
P Os listeners são sobrescritos?
R Não — todos os listeners rodam em ordem.
P Manual ou automático?
R O fallthrough de atributos mescla automaticamente; código de render manual precisa dele.
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%