Formations — 1 037 leçons en français

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/@HostListener pour 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 TemplateRef et un ViewContainerRef. @if et @for remplacent 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

TemplateRef référence un fragment de template non rendu (le contenu porté par la directive structurelle). ViewContainerRef représente l'endroit du DOM où l'insérer : createEmbeddedView(templateRef) l'affiche, clear() le retire.

hostDirectives

Propriété du décorateur @Component/@Directive qui 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.

Lire l'explication détaillée et faire le quiz →

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.