app.component() Registrar um componente global
Última atualização: 2026-10-22
app.component() Registrar um componente global
app.component() registra um componente globalmente, disponível para todos os templates — ideal para componentes base como botões e ícones.
| Grupo | API Global |
|---|---|
| Tipo | API |
| Escopo | Global |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
app.component("my-btn", { template: "<button><slot></slot></button>" })⚙️ Argumentos
| name, component? | Um nome mais a definição (passar apenas o nome retorna o componente registrado) |
|---|
Retorno：A instância da aplicação (encadeável)
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Renders a button labelled 'Global button'.💡 Pontos-chave
⚠️ Aviso Globais não podem ser tree-shaken — prefira registro local.
💡 Dica Reserve os globais para UI base; registre componentes de negócio localmente.
ℹ️ Nota Registre antes de montar, normalmente no arquivo de entrada.
🏷️ API Global relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Global ou local?
R Local mantém as dependências explícitas e tree-shakable.
P Há regras de nomenclatura?
R Use nomes com múltiplas palavras para evitar conflito com tags nativas.
P E se eu registrar um nome duplicado?
R O último registro vence, com um aviso em desenvolvimento.
