Formations — 1 037 leçons en français

Accueil › Angular › Intégrer des librairies tierces

Intégrer des librairies tierces

Patterns avancés et interopérabilitéavance

La plupart des librairies JavaScript utiles (cartes, graphiques, éditeurs de texte riche, lecteurs vidéo…) ne connaissent rien d'Angular. Le pattern standard consiste à les envelopper dans un service ou une directive Angular : créer l'instance dans ngOnInit (ou afterNextRender si elle touche au DOM), exposer une API Angular-idiomatique (input(), output(), signal), et toujours nettoyer dans ngOnDestroy — instance détruite, écouteurs globaux retirés, abonnements fermés.

@Directive({ selector: '[appGraphique]' })
export class GraphiqueDirective implements OnInit, OnDestroy {
  private elementRef = inject(ElementRef);
  private graphique?: LibGraphique;

  donnees = input.required<PointDonnee[]>();

  ngOnInit() {
    this.graphique = new LibGraphique(this.elementRef.nativeElement, { donnees: this.donnees() });
  }

  ngOnDestroy() {
    this.graphique?.detruire();
  }
}

Deux problèmes reviennent systématiquement :

  1. Exécuter du code intensif hors du cycle Angular. Pour un défilement ou une animation à haute fréquence pilotée par la librairie, NgZone.runOutsideAngular() évite de solliciter la détection de changements à chaque image — utile même en zoneless, l'équipe Angular précisant qu'il n'y a pas besoin de retirer ces appels.
  2. Le problème inverse : une librairie modifie un état sans qu'Angular le sache. En zoneless en particulier, rien ne rafraîchit automatiquement l'affichage. La solution la plus propre est de recopier la valeur reçue dans un signal ; à défaut, appeler ChangeDetectorRef.markForCheck() explicitement.

Autres points à surveiller : types TypeScript manquants (declare module pour une librairie sans typage officiel), chargement différé d'une grosse librairie (import dynamique), et compatibilité SSR — tout code touchant window/document doit être protégé par isPlatformBrowser() ou déplacé dans afterNextRender.

Les termes à connaître

Service ou directive enveloppant (wrapper)

Composant, directive ou service Angular dont le seul rôle est d'encapsuler une librairie JavaScript non-Angular : créer l'instance, exposer une API Angular-idiomatique (signaux, input()/output()), et la détruire proprement. Isole le reste de l'application du détail d'implémentation de la librairie.

ngOnDestroy

Hook de cycle de vie appelé juste avant la destruction d'un composant ou d'une directive. Emplacement correct pour libérer les ressources créées par une librairie tierce : instance à détruire, écouteurs globaux (window, document) à retirer, abonnements à fermer.

NgZone.runOutsideAngular()

Méthode qui exécute une fonction en dehors de la détection de changements automatique. Reste utile pour du code intensif ou fréquent (défilement, animation au pixel près) même en zoneless ; l'équipe Angular précise explicitement qu'il n'est pas nécessaire de retirer ces appels pour être compatible zoneless.

markForCheck() / signal de synchronisation

Deux façons de prévenir Angular qu'une donnée modifiée par du code extérieur (librairie tierce) doit rafraîchir l'affichage : recopier la valeur reçue dans un signal (le template se met à jour tout seul), ou appeler ChangeDetectorRef.markForCheck() pour forcer une vérification explicite du composant.

Déclaration de types ambiante

Fichier .d.ts (declare module 'nom-librairie' { ... }) qui décrit les types d'une librairie JavaScript dépourvue de typage TypeScript officiel, pour retrouver l'autocomplétion et la vérification de types sans modifier le code source de la librairie.

isPlatformBrowser()

Fonction de @angular/common qui, combinée à PLATFORM_ID injecté, indique si le code s'exécute dans un navigateur ou côté serveur (SSR). Sert de garde avant tout accès à window/document ou à une librairie qui en dépend.

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.