useHost() Acessar o host do custom element
Última atualização: 2026-10-22
useHost() Acessar o host do custom element
useHost() retorna o elemento host dentro de um custom element, permitindo manipular seus atributos ou estilos.
| Grupo | Funções de Renderização e SSR |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
const host = useHost()
host.style.border = "1px solid"Retorno：O elemento host (a própria tag do custom element)
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows the notice — the host is only available inside custom elements.💡 Pontos-chave
ℹ️ Nota Só faz sentido junto com defineCustomElement.
💡 Dica Use-o para ler ou escrever atributos do host.
⚠️ Aviso Não substitua a reatividade por mutação direta do host.
🏷️ Funções de Renderização e SSR relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
Integração de bibliotecas de componentes de UI
Lição 29 do tutorial: trabalhando com o elemento host
❓ FAQ
P Lança erro em componentes comuns?
R Não — retorna null.
P Diferença em relação a this.$el?
R $el é a raiz do componente; useHost é a própria tag do custom element.
P Dá para estilizar o host?
R Sim, embora estilizar via props seja preferível.
