withModifiers() Aplicar modificadores de evento
Última atualização: 2026-10-22
withModifiers() Aplicar modificadores de evento
withModifiers() aplica comportamentos de modificadores como stop, prevent e once a handlers dentro de render functions.
| Grupo | Funções de Renderização e SSR |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
h("button", { onClick: withModifiers(fn, ["prevent", "stop"]) }, "Submit")⚙️ Argumentos
| handler, modifiers | Um handler mais um array de nomes de modificadores |
|---|
Retorno：Um handler encapsulado
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Inner clicks stop at the inner handler; outer clicks log the outer one.💡 Pontos-chave
ℹ️ Nota Os modificadores de template compilam para ele.
💡 Dica Use-o em código de render manual.
⚠️ Aviso Passe nomes curtos como stop, prevent, self, once.
🏷️ Funções de Renderização e SSR relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P É necessário em templates?
R Não — templates têm açúcar sintático para modificadores.
P Dá para empilhar modificadores?
R Sim — eles são aplicados em ordem.
P Versus stopPropagation manual?
R Mesmo efeito, menos código.
