Accueil › Angular › Les directives
Les directives
Composer des composantsdebutant
Une directive ajoute un comportement à un élément existant, sans template propre (contrairement à un composant). On distingue deux familles.
Directive d'attribut : modifie l'apparence ou le comportement d'un élément.
@Directive({
selector: '[appSurbrillance]',
host: {
'(mouseenter)': 'actif.set(true)',
'(mouseleave)': 'actif.set(false)',
'[class.surligne]': 'actif()',
},
})
export class Surbrillance {
protected actif = signal(false);
}
<p appSurbrillance>Survolez-moi</p>
Directive structurelle : ajoute, retire ou répète des éléments du DOM, à l'aide d'un TemplateRef (le contenu) et d'un ViewContainerRef (où l'insérer). Pour l'immense majorité des cas, le contrôle de flux intégré (@if, @for, @switch) remplace aujourd'hui les anciennes directives *ngIf/*ngFor/*ngSwitch, dépréciées depuis Angular 20 mais toujours fonctionnelles. Écrire sa propre directive structurelle reste utile pour des besoins métier spécifiques (afficher un contenu selon un rôle, une feature flag...).
hostDirectives permet de composer une directive existante dans un composant, sans héritage.
Les termes à connaître
- @Directive
Décorateur qui définit une directive : une classe qui ajoute un comportement à un élément existant, sans créer de nouvel élément visuel (contrairement à
@Component, une directive n'a pas de template). Standalone par défaut, comme les composants.- host
Propriété du décorateur
@Directive(ou@Component) qui déclare des liaisons sur l'élément hôte : classes, styles, attributs, écouteurs d'événements. Remplace l'usage de@HostBinding/@HostListenerpour le nouveau code.- Directive d'attribut
Directive appliquée comme un attribut sur un élément existant (
<div appSurbrillance>), qui modifie son apparence ou son comportement sans changer la structure du DOM autour.- Directive structurelle
Directive qui ajoute, retire ou répète des éléments du DOM en s'appuyant sur un
TemplateRefet unViewContainerRef.@ifet@forremplacent aujourd'hui les cas d'usage les plus courants (anciennement*ngIf,*ngFor) ; écrire sa propre directive structurelle reste utile pour des besoins spécifiques (permissions, feature flags).- TemplateRef / ViewContainerRef
TemplateRefréférence un fragment de template non rendu (le contenu porté par la directive structurelle).ViewContainerRefreprésente l'endroit du DOM où l'insérer :createEmbeddedView(templateRef)l'affiche,clear()le retire.- hostDirectives
Propriété du décorateur
@Component/@Directivequi permet de composer une directive existante dans un composant, en réutilisant son comportement (et éventuellement certaines de ses entrées/sorties) sans héritage ni duplication de code.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.