A propriedade hostDirectives
Anexe diretivas ao hospedeiro de um componente.
A propriedade hostDirectives é uma aula grátis de Angular Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Angular Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Angular Academy inclui 4 aulas no total.
API de composição de diretivas
A API de composição de diretivas permite que um componente ou uma diretiva aplique declarativamente outras diretivas ao próprio elemento hospedeiro por meio da propriedade hostDirectives. Isso permite a reutilização sem herança.
O problema que ela resolve
Anteriormente, para reutilizar o comportamento de uma diretiva, você precisava repetir a diretiva em cada modelo ou usar herança. hostDirectives compõe comportamentos diretamente em um hospedeiro.
Sintaxe básica
Liste as diretivas na matriz hostDirectives dos metadados do componente.
@Component({
selector: 'app-menu',
hostDirectives: [CdkTrapFocus],
template: '<ng-content></ng-content>'
})
export class MenuComponent {}O que acontece
O Angular aplica CdkTrapFocus automaticamente a cada elemento hospedeiro app-menu. Os consumidores obtêm esse comportamento sem precisar adicionar a diretiva por conta própria.
Requisitos
As diretivas hospedeiras devem ser independentes. Faça referência diretamente à classe da diretiva, não ao seletor dela.
Várias diretivas hospedeiras
Componha vários comportamentos listando-os todos.
hostDirectives: [
HighlightDirective,
TooltipDirective,
CdkTrapFocus
]Aplicando a uma diretiva
Uma diretiva também pode ter diretivas hospedeiras, permitindo criar comportamentos em camadas e compostos.
@Directive({
selector: '[appCard]',
hostDirectives: [HoverElevateDirective]
})
export class CardDirective {}Ordem do ciclo de vida
As diretivas hospedeiras são instanciadas antes da lógica do próprio construtor do hospedeiro, portanto sua configuração já está disponível quando o hospedeiro é inicializado.
Injeção de dependências
As diretivas hospedeiras podem ser injetadas no hospedeiro, e vice-versa, por meio do injetor do elemento, permitindo a coordenação entre comportamentos compostos.
private trap = inject(CdkTrapFocus);Sem alterações no modelo
A principal vantagem: os consumidores de app-menu não precisam conhecer CdkTrapFocus. O comportamento fica encapsulado na definição do componente.
Quando usar
Use hostDirectives para agrupar de forma organizada e reutilizável comportamentos transversais, como captura de foco, ondulação e análise, em componentes ou diretivas.
Verificação rápida
Verifique sua compreensão de hostDirectives.
Recapitulação
Você aprendeu que a propriedade hostDirectives aplica automaticamente diretivas independentes ao elemento hospedeiro de um componente ou diretiva, permitindo reutilizar comportamentos por meio de composição, sem modelos nem herança.
Perguntas Frequentes
A aula “A propriedade hostDirectives” é grátis?
Sim — o texto completo de “A propriedade hostDirectives” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Angular Academy, atualize para CoddyKit PRO. O curso de Angular Academy inclui 4 aulas no total.
O que vou aprender em “A propriedade hostDirectives”?
Anexe diretivas ao hospedeiro de um componente. Você pratica Angular Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Angular Academy?
Nenhuma experiência prévia é necessária. Angular Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “A propriedade hostDirectives”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Angular Academy?
Sim. Cada aula de Angular Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- A propriedade hostDirectives
- Expondo entradas e saídas
- Criando comportamentos reutilizáveis
- Composição versus herança