Formations — 1 037 leçons en français

Accueil › Angular › Créer des composants dynamiquement

Créer des composants dynamiquement

Patterns avancés et interopérabilitéavance

Créer un composant dynamiquement veut dire l'instancier par code, sans qu'il apparaisse dans un template : boîte de dialogue de confirmation, système de notifications empilées, ou formulaire dont les champs dépendent d'une configuration reçue à l'exécution (un composant différent par type de champ). Le template classique (<app-x />) ne suffit pas quand on ne connaît pas le composant à afficher au moment de la compilation.

L'outil de base est ViewContainerRef.createComponent() :

@Component({ template: `<ng-container #ancre />` })
export class HoteNotifications {
  private ancre = viewChild.required('ancre', { read: ViewContainerRef });

  afficher(message: string) {
    const ref = this.ancre().createComponent(NotificationToast);
    ref.setInput('message', message);       // pas d'affectation directe sur .instance
    ref.instance.fermee.subscribe(() => ref.destroy());
  }
}

setInput() — pas une affectation directe sur instance — pour que le composant en OnPush soit correctement notifié. Les sorties (output()) s'écoutent directement sur instance. Il faut retenir le ComponentRef pour appeler destroy() le moment venu : rien ne le fait automatiquement.

Pour un cas simple (afficher tel ou tel composant selon une condition, sans logique fine), NgComponentOutlet évite d'écrire ce code à la main. Pour des boîtes de dialogue, @angular/cdk/dialog (module Dialog) fournit une solution complète (superposition, focus, accessibilité) plutôt que de réinventer createComponent() à chaque fois.

Les termes à connaître

ViewContainerRef

Représente un emplacement dans l'arbre de vues où des composants ou des vues peuvent être insérés dynamiquement. On l'obtient par injection (inject(ViewContainerRef)) ou via un viewChild pointant vers un <ng-container> ou une directive ancre.

createComponent()

Méthode de ViewContainerRef qui instancie un composant et l'insère dans la vue. Accepte le type du composant et un objet d'options (injector, index, projectableNodes…). Retourne un ComponentRef.

ComponentRef

Handle retourné par createComponent(), donnant accès à instance (l'instance du composant), setInput(), destroy(), onDestroy() et location (l'élément hôte dans le DOM).

setInput()

Méthode de ComponentRef qui met à jour une entrée du composant créé dynamiquement. Contrairement à une affectation directe sur instance, elle notifie correctement Angular (marque le composant pour vérification, y compris en OnPush).

NgComponentOutlet

Directive structurelle qui rend un composant dynamiquement à partir d'un Type fourni au template (ngComponentOutlet), avec des entrées via ngComponentOutletInputs. Alternative déclarative à createComponent() pour les cas simples.

Contexte d'injection

Portée dans laquelle inject() peut être appelé (constructeur, initialiseur de champ, fonction exécutée via runInInjectionContext()…). Un composant créé dynamiquement doit recevoir un Injector explicite si on veut lui fournir des dépendances hors de la hiérarchie d'injection standard.

@angular/cdk/dialog

Module du Component Dev Kit fournissant un service Dialog prêt à l'emploi (ouverture, fermeture, superposition, gestion du focus, accessibilité) construit au-dessus de @angular/cdk/overlay. Évite de réimplémenter createComponent() à la main pour des boîtes de dialogue.

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.