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 unviewChildpointant vers un<ng-container>ou une directive ancre.- createComponent()
Méthode de
ViewContainerRefqui instancie un composant et l'insère dans la vue. Accepte le type du composant et un objet d'options (injector,index,projectableNodes…). Retourne unComponentRef.- ComponentRef
Handle retourné par
createComponent(), donnant accès àinstance(l'instance du composant),setInput(),destroy(),onDestroy()etlocation(l'élément hôte dans le DOM).- setInput()
Méthode de
ComponentRefqui met à jour une entrée du composant créé dynamiquement. Contrairement à une affectation directe surinstance, elle notifie correctement Angular (marque le composant pour vérification, y compris enOnPush).- NgComponentOutlet
Directive structurelle qui rend un composant dynamiquement à partir d'un
Typefourni au template (ngComponentOutlet), avec des entrées viangComponentOutletInputs. 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 viarunInInjectionContext()…). Un composant créé dynamiquement doit recevoir unInjectorexplicite 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
Dialogprêt à l'emploi (ouverture, fermeture, superposition, gestion du focus, accessibilité) construit au-dessus de@angular/cdk/overlay. Évite de réimplémentercreateComponent()à la main pour des boîtes de dialogue.
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.