v-once Renderizar Apenas uma Vez
Última atualização: 2026-10-22
v-once Renderizar Apenas uma Vez
O v-once renderiza o elemento uma única vez; mudanças posteriores nos dados não o re-renderizam — uma micro-otimização para conteúdo estático.
| Grupo | Diretivas |
|---|---|
| Tipo | Diretiva |
| Escopo | Template |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
<p v-once>Valor inicial: {{ msg }}</p>⚙️ Argumentos
| expression | Sem expressão |
|---|
Retorno：Diretiva, sem valor de retorno
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
After clicking, the live paragraph updates while the frozen one keeps the initial text.💡 Pontos-chave
ℹ️ Nota Ideal para número de versão, linha de copyright e outros conteúdos que nunca mudam.
⚠️ Aviso Mudanças posteriores nos dados nunca chegam a um nó v-once — usá-lo em conteúdo dinâmico por engano causa saída desatualizada.
💡 Dica O v-once cobre toda a subárvore do elemento.
🏷️ Diretivas relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Que conteúdo combina com o v-once?
R Texto estático que nunca muda após a montagem, como linhas de copyright ou de versão.
P Por que a página não atualiza quando os dados mudam?
R Por design, essa subárvore sai do pipeline de renderização — o uso indevido exibe dados desatualizados.
P Pode ser combinado com v-for?
R Pode, mas para listas dinâmicas o v-memo é a ferramenta certa.
