app.directive() Registrar uma diretiva global
Última atualização: 2026-10-22
app.directive() Registrar uma diretiva global
app.directive() registra uma diretiva personalizada global, utilizável como v-xxx em qualquer lugar — para permissões, clique fora e comportamentos semelhantes.
| Grupo | API Global |
|---|---|
| Tipo | API |
| Escopo | Global |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
app.directive("focus", {
mounted(el) { el.focus() }
})⚙️ Argumentos
| name, directive? | O nome (sem o prefixo v-) mais uma definição com hooks |
|---|
Retorno：A instância da aplicação (encadeável)
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
The input receives focus automatically.💡 Pontos-chave
ℹ️ Nota Os hooks de diretiva espelham os nomes do ciclo de vida.
💡 Dica Prefira composables; diretivas servem para comportamento reutilizável de DOM puro.
⚠️ Aviso Argumentos e modificadores ficam no objeto binding.
🏷️ API Global relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Diretiva ou composable?
R Comportamento de DOM puro → diretiva; lógica com estado → composable.
P Diretivas podem receber argumentos?
R Sim — leia binding.arg, modifiers e value.
P E diretivas locais?
R Declare-as na opção directives do componente.
