AngularAtlaséd. 22.2

Chap. 07Architecture d’application40 / 75

State Management avec les Signals

Stores simples à base de Signals, facades, état local vs global, et quand NgRx devient nécessaire.

architecture ~0 min de lecture Documentation officielle

Avec les Signals, la plupart des applications n’ont plus besoin d’une bibliothèque de State Management. Un service avec quelques signals privés, des sélecteurs computed() et des méthodes aux noms explicites couvre presque tous les cas. La question importante n’est pas « quelle bibliothèque », mais où vit chaque morceau d’état. Quand un écran atteint sans cesse des combinaisons qui ne devraient pas exister, la réponse est une machine à états.

Les niveaux d’état

Type d’état         Exemple                              Où le garder
────────────────────────────────────────────────────────────────────────────────
UI locale           dropdown ouvert, survol, onglet      signal() dans le composant
Formulaire          champs, validation, dirty            Signal Forms (form())
Feature             filtres, sélection, liste            store @Injectable() sur la route/page
Serveur             produits, commandes                  resource / httpResource (dans le store)
URL                 recherche, page, filtre partageable  query params + input() (router)
Global              utilisateur, panier, thème, langue   @Service() dans root
La règle

Gardez l’état au niveau le plus bas où il est nécessaire. Ne le remontez (composant → feature → global) que lorsqu’un nouveau consommateur l’exige.

Le pattern de base : un store basé sur les Signals

@Injectable() // fourni par la page / route de la feature
export class TodoStore {
  // 1. ÉTAT — privé, modifiable
  private readonly _todos = signal<Todo[]>([]);
  private readonly _filter = signal<TodoFilter>('all');

  // 2. SÉLECTEURS — publics, en lecture seule
  readonly todos = this._todos.asReadonly();
  readonly filter = this._filter.asReadonly();
  readonly visible = computed(() => {
    const f = this._filter();
    return this._todos().filter((t) => f === 'all' || (f === 'done' ? t.done : !t.done));
  });
  readonly remaining = computed(() => this._todos().filter((t) => !t.done).length);

  // 3. ACTIONS — méthodes aux noms métier, mises à jour immuables
  add(title: string) {
    this._todos.update((list) => [...list, { id: Date.now(), title, done: false }]);
  }
  toggle(id: number) {
    this._todos.update((list) => list.map((t) => (t.id === id ? { ...t, done: !t.done } : t)));
  }
  setFilter(filter: TodoFilter) {
    this._filter.set(filter);
  }
}
LiveStore de feature + persistance + synchronisation avec l’URL
2 restantes

Le filtre est aussi dans l’URL (?filtru=…) — rechargez la page : la liste (localStorage) et le filtre (URL) sont conservés.

Le filtre va dans l’URL (?filtru=…), la liste dans localStorage. Le composant ne sait rien de l’implémentation du store.

État du serveur

Les données du serveur ne sont pas « votre état » — c’est un cache de l’état du serveur. Gardez-les dans un httpResource/resource à l’intérieur du store, et après les écritures, rechargez ou mettez à jour localement.

// Un store avec des données serveur : resource pour lire, HttpClient pour écrire
@Service()
export class ProductsStore {
  private readonly api = inject(ProductsApi);

  readonly query = signal('');
  readonly page = linkedSignal({ source: this.query, computation: () => 1 });

  readonly products = httpResource<PageDto<Product>>(
    () => ({ url: '/api/products', params: { q: this.query(), page: this.page() } }),
    { defaultValue: { items: [], total: 0 } },
  );

  readonly isEmpty = computed(() => !this.products.isLoading() && this.products.value().items.length === 0);

  async remove(id: number) {
    await firstValueFrom(this.api.delete(id));
    this.products.reload();
  }
}

L’URL est aussi de l’état

// État qui doit survivre à un rafraîchissement / pouvoir être envoyé en lien → l’URL
// avec withComponentInputBinding(), les query params arrivent directement dans les inputs :
@Component({ /* routé sur /products?q=laptop&page=2 */ })
export class ProductsPage {
  readonly q = input<string>('');               // ?q=
  readonly page = input(1, { transform: numberAttribute }); // ?page=

  private readonly router = inject(Router);

  search(q: string) {
    this.router.navigate([], { queryParams: { q, page: null }, queryParamsHandling: 'merge' });
  }
}

Facade

Quand une page combine les données de plusieurs stores, une facade les rassemble en un seul « view model ». Le composant reste léger, et l’orchestration a une place claire.

// Facade : un point d’entrée unique pour la page, qui masque plusieurs sources
@Injectable()
export class CheckoutFacade {
  private readonly cart = inject(CartStore);
  private readonly user = inject(AuthStore);
  private readonly shipping = inject(ShippingStore);

  readonly vm = computed(() => ({
    items: this.cart.items(),
    total: this.cart.total(),
    address: this.user.current()?.address,
    shippingOptions: this.shipping.options.value(),
    canPay: this.cart.items().length > 0 && !!this.user.current(),
  }));

  pay() { /* orchestration entre stores */ }
}
// le composant : @let vm = facade.vm();  — un seul objet, facile à tester

Et NgRx ?

// Quand l’équipe veut des conventions + des plugins : NgRx SignalStore (@ngrx/signals)
export const TodoStore = signalStore(
  withState({ todos: [] as Todo[], filter: 'all' as TodoFilter }),
  withComputed(({ todos, filter }) => ({
    visible: computed(() => todos().filter(/* ... */)),
  })),
  withMethods((store) => ({
    add(title: string) {
      patchState(store, (s) => ({ todos: [...s.todos, { id: Date.now(), title, done: false }] }));
    },
  })),
);
// + withEntities, withHooks, devtools, rxMethod pour les effets asynchrones
Services basés sur les Signals (par défaut)
  • La plupart des applications, y compris les grandes.
  • Les équipes qui préfèrent un code simple, sans boilerplate.
  • L’état de feature, lié aux pages.
NgRx SignalStore / Store
  • SignalStore : vous voulez des conventions imposées, des entités, des hooks, des plugins réutilisables.
  • NgRx Store (Redux) : vous avez besoin d’un journal d’actions, de time-travel, d’event sourcing, de nombreuses équipes sur le même état.
  • L’application utilise déjà NgRx — gardez la cohérence.

Pièges fréquents

  • Tout en global : l’état d’une page dans root → d’anciens filtres réapparaissent au retour, la mémoire grossit. Fournissez le store au niveau de la route/page.
  • Des signals modifiables publics dans un store → n’importe qui peut changer l’état de n’importe où. Exposez asReadonly().
  • De l’état dupliqué (la même liste dans deux stores) → désynchronisation. Une seule source, le reste dérivé.
  • Des stores qui s’injectent mutuellement de façon circulaire → le signe qu’un concept doit être déplacé (ou qu’il vous faut une facade).

Chap. 07 · 0 sur 7 terminées

Leçon terminée ?

Marquez-la : elle apparaîtra sur votre carte, dans le sommaire et sur la page d’accueil.

Se marque toute seule une fois la leçon lue en entier.

  1. Structure des dossiers
  2. Shared vs feature
  3. Interfaces et modèles
  4. State Management avec les Signals
  5. Guide de style et nommage
  6. Barrels, alias et frontières
  7. Erreurs : @boundary et ErrorHandler
Voir toute votre carte

Les 75 pages · tapez pour filtrer

  • 01Nouveautés d’Angular 21 & 22Tous les changements importants de la v21 et de la v22, en bref, avec un lien vers la page qui explique chacun.Départ
  • 01Votre première application, pas à pasUne liste de lecture construite d’un composant vide jusqu’à une application terminée — signals, @for, inputs et outputs, un service et un formulaire, pas à pas.Départ
  • 01Décisions rapides« Où mettre ça ? », « Signal ou Observable ? », « Shared ou feature ? » — des réponses courtes aux questions de tous les jours.Départ
  • 01Questions d’entretien Angular60 vraies questions d’entretien pour profils junior, confirmé et senior, avec la réponse à donner, la relance et les signaux d’alerte. Plus un entretien blanc.Départ
  • 02Standalone et bootstrapComment une application démarre sans NgModule : bootstrapApplication, app.config.ts, imports dans le composant.Fondamentaux modernes
  • 02Data binding et événementsInterpolation, bindings de propriétés et d’attributs, événements avec $event et filtres de touches, et comment [( )] est construit — ce qui entre dans le DOM et ce qui en revient.Fondamentaux modernes
  • 02Control Flow : @if, @for, @switchLa syntaxe de blocs qui remplace *ngIf/*ngFor/ngSwitch, avec track, @empty et vérifications d’exhaustivité.Fondamentaux modernes
  • 02@let et les nouvelles expressions de templateVariables locales avec @let, fonctions fléchées, spread, regex, instanceof, commentaires dans les balises.Fondamentaux modernes
  • 02@defer — Lazy Loading dans les templatesChargez les composants lourds uniquement quand c’est nécessaire : triggers, prefetch, placeholder, loading, error.Fondamentaux modernes
  • 02Bindings de classe et de stylePourquoi [class.x] et [style.x] ont remplacé ngClass et ngStyle (avec migration automatique depuis la v21).Fondamentaux modernes
  • 02Styles des composants et encapsulation:host, les trois modes d’encapsulation, les thèmes avec des variables CSS, et pourquoi ::ng-deep est un dernier recours.Fondamentaux modernes
  • 02Pipes : quand et commentPipes pures vs impures, pipes personnalisées, et comment choisir entre une pipe, computed() et une méthode.Fondamentaux modernes
  • 03signal() et computed()Les primitives réactives : état modifiable, état dérivé, égalité, untracked et règles d’immutabilité.Signals et réactivité
  • 03effect() — quand OUI, quand NONEffets de bord synchronisés avec les Signals : localStorage, logs, API impératives. Et leurs pièges.Signals et réactivité
  • 03linkedSignal() — état dérivé modifiableUn signal qui se réinitialise quand sa source change, mais que vous pouvez aussi modifier à la main.Signals et réactivité
  • 03resource, rxResource, httpResourceDes données asynchrones sous forme de Signals : status, value, error, reload, annulation automatique. Stable depuis la v22.Signals et réactivité
  • 03debounced() — signals différésLa version « debounce » d’un signal, sans RxJS. Parfait pour la recherche.Signals et réactivité
  • 03Listes : rechercher, filtrer, trier, paginerUne chaîne de signals computed qui ne recalcule que ce qui a changé, avec les filtres dans l’URL pour qu’un lien rouvre la même vue.Signals et réactivité
  • 03Les Observables depuis zéroCe qu’est un Observable, subscribe et unsubscribe, les opérateurs que vous utilisez chaque semaine, froid ou chaud — et quand un signal suffit.Signals et réactivité
  • 03Signals ↔ RxJStoSignal, toObservable, takeUntilDestroyed, outputFromObservable — et quand RxJS reste le bon choix.Signals et réactivité
  • 04input() et output()Les inputs comme Signals (required, transform, alias) et les outputs typés. Les données descendent, les événements remontent.Composants : communication
  • 04model() — binding bidirectionnelLe « banana-in-a-box » [( )] avec une seule API. Quand l’utiliser, et quand input + output est préférable.Composants : communication
  • 04viewChild et contentChildLes queries comme Signals : viewChild, viewChildren, contentChild, contentChildren, l’option read.Composants : communication
  • 04Lifecycle et DestroyRefQuels hooks comptent encore à l’ère des Signals, afterNextRender, DestroyRef et ngOnChanges typé.Composants : communication
  • 04Projection de contenung-content avec select, plusieurs slots, contenu par défaut et le piège de la projection conditionnelle.Composants : communication
  • 04ng-template et ngTemplateOutletLes templates comme valeurs : les render props en Angular, contexte typé et personnalisation des composants.Composants : communication
  • 05Smart vs DumbContainer vs présentation : qui détient l’état, qui se contente d’afficher, et comment bien les séparer.Conception des composants
  • 05Composants génériques <T>Un DataTable<T> ou un Select<T> correctement typé, avec des templates pour les cellules.Conception des composants
  • 05Composants dynamiquesNgComponentOutlet, createComponent avec inputBinding/outputBinding, et un tableau de bord construit à partir d’une configuration.Conception des composants
  • 05Directives et composition d’hôteLes directives d’attribut, les métadonnées host: {} et la Directive Composition API (hostDirectives).Conception des composants
  • 05Contrôles de formulaire personnalisésFormValueControl (Signal Forms) vs ControlValueAccessor : une notation par étoiles, dans les deux variantes.Conception des composants
  • 05Change DetectionOnPush est la valeur par défaut depuis la v22, Zone.js a disparu depuis la v21. Ce qui déclenche le rendu et comment éviter les mauvaises surprises.Conception des composants
  • 06inject() et @Service()Le nouveau décorateur @Service() de la v22, inject() vs le constructeur, et le contexte d’injection.Dependency Injection
  • 06Providers et hiérarchie des injecteursRoot vs route vs composant, useClass/useValue/useFactory/useExisting, et les modificateurs optional/self/skipSelf.Dependency Injection
  • 06InjectionToken et provideX()Configuration typée, fonctions provideFeature(), makeEnvironmentProviders et initializers.Dependency Injection
  • 06injectAsync() — services en Lazy LoadingChargez un service lourd uniquement quand vous en avez besoin, avec prefetch à l’idle.Dependency Injection
  • 07Structure des dossierscore / shared / features, ce que contient chacun, et à quoi ressemble l’intérieur d’une feature.Architecture d’application
  • 07Shared vs featureQuand déplacer un composant dans shared et (surtout) quand NE PAS le faire. Une checklist concrète.Architecture d’application
  • 07Interfaces et modèlesInterface en ligne ou fichier séparé ? DTO vs modèle de domaine, type vs interface, où les ranger.Architecture d’application
  • 07State Management avec les SignalsStores simples à base de Signals, facades, état local vs global, et quand NgRx devient nécessaire.Architecture d’application
  • 07Guide de style et nommageLes conventions officielles actuelles : noms de fichiers sans suffixes, protected, readonly, ordre des membres.Architecture d’application
  • 07Barrels, alias et frontièresindex.ts, alias de chemins, API publique d’une feature et règles de dépendances vérifiables automatiquement.Architecture d’application
  • 07Erreurs : @boundary et ErrorHandlerLe nouveau bloc @boundary de la v22.2, l’ErrorHandler global, les erreurs HTTP et les erreurs de resource.Architecture d’application
  • 08Routing moderne et Lazy LoadingloadComponent, routes enfants, paramètres comme inputs et héritage des paramètres (le nouveau comportement par défaut de la v22).Routing
  • 08Guards et resolverscanActivate, canMatch, canDeactivate et resolve sous forme de fonctions, avec redirections via UrlTree / RedirectCommand.Routing
  • 09Signal Forms — les basesDes formulaires bâtis sur les Signals : form(), [formField], validation par schéma. Stable depuis la v22.Formulaires
  • 09Signal Forms — avancéValidation personnalisée et inter-champs, async/HTTP avec debounce, listes dynamiques, désactivé/masqué, schémas réutilisables.Formulaires
  • 09Reactive Forms typésFormGroup typé, nonNullable, FormArray — et leur cohabitation avec les Signal Forms.Formulaires
  • 10HttpClient, interceptors et couche d’APIHttpClient sans configuration (v21), Fetch par défaut (v22), interceptors fonctionnels et une couche d’API avec mapping des DTO.HTTP et données
  • 11Performance — une checklistCe qui compte vraiment : OnPush + Signals, track, @defer, routes en Lazy Loading, images, bundles et Hydration.Qualité et performance
  • 11Tests avec VitestVitest est le runner par défaut depuis la v21. TestBed, composants avec Signals, services, HTTP et harnesses.Qualité et performance
  • 11DevTools : regarder dans votre applicationChrome DevTools et Angular DevTools pas à pas : ce que montre chaque panneau, avec des exercices qui fonctionnent sur ce site.Qualité et performance
  • 11Angular AriaDes composants headless et accessibles que vous stylez comme vous voulez : tabs, accordion, menu, listbox...Qualité et performance
  • 12SSR, Prerendering et modes de renduQuand rendre sur le serveur, quand au build et quand uniquement dans le navigateur : RenderMode par route, app.routes.server.ts et les coûts réels.SSR et Hydration
  • 12Hydration : event replay et incrémentaleComment le navigateur reprend le HTML du serveur sans le re-rendre : Hydration complète, event replay, @defer (hydrate on …) et erreurs de mismatch.SSR et Hydration
  • 12Code compatible serveurwindow n’existe pas sur le serveur : PLATFORM_ID, afterNextRender, DOCUMENT, TransferState, le cache HTTP et PendingTasks.SSR et Hydration
  • 13Micro frontendsQuand découper une application en plusieurs déploiements vaut le coup, et quand c’est juste de la complexité : Native Federation, Module Federation, iframes, Web Components.Architecture à grande échelle
  • 13Web Components avec Angular ElementscreateCustomElement : un composant Angular utilisé comme balise HTML n’importe où, plus la communication entre applications via des événements et BroadcastChannel.Architecture à grande échelle
  • 13Monorepo, bibliothèques et frontièresUn workspace avec plusieurs applications et bibliothèques : ng generate library, Nx, points d’entrée secondaires, publication et règles de dépendances.Architecture à grande échelle
  • 13Architecture hexagonale (ports et adapters)Un domaine sans Angular, des ports sous forme de classes abstraites et des adapters interchangeables : HTTP, localStorage ou en mémoire, sans toucher à l’UI.Architecture à grande échelle
  • 14Les Signals sous le capotLe graphe réactif : producteurs et consommateurs, push-pull, pourquoi computed est lazy et sans glitch, le problème du diamant et quand les effects s’exécutent.Réactivité avancée
  • 14RxJS avancé : opérateurs d’ordre supérieurswitchMap, mergeMap, concatMap et exhaustMap sur un diagramme interactif, plus retry avec backoff, shareReplay et comment éviter les fuites.Réactivité avancée
  • 14NgRx SignalStoreState Management à grande échelle sur les Signals : withState, withComputed, withMethods, rxMethod, entités et hooks — et quand un store simple suffit.Réactivité avancée
  • 14Machines à états avec les signalsFini les états impossibles : une machine typée sur des signals, avec transitions, gardes et un diagramme d’états en direct.Réactivité avancée
  • 15WebSockets : un temps réel qui résiste au réseauUn socket typé sous forme de signals : reconnexion avec backoff et jitter, heartbeat, file d’attente hors ligne et sécurité SSR.Temps réel et hors ligne
  • 15Mises à jour optimistes et rollbackUne UI instantanée qui reste honnête : snapshot et rollback, réponses dans le désordre, clés d’idempotence.Temps réel et hors ligne
  • 15Offline-first : Service Worker et cacheLe Service Worker d’Angular : stratégies de cache, annonce des nouvelles versions et file d’attente pour les modifications faites hors ligne.Temps réel et hors ligne
  • 16Web WorkersDes calculs lourds sans bloquer l’UI : un vrai worker dans la page, l’échange de messages et quand ça n’en vaut pas la peine.UI avancée et performance
  • 16Listes géantes : virtual scroll100 000 lignes sans latence : le virtual scroll du CDK, itemSize, trackBy et les alternatives (pagination, scroll infini).UI avancée et performance
  • 16Animations modernes et View Transitionsanimate.enter et animate.leave à la place de @angular/animations (déprécié), transitions CSS et View Transitions à la navigation.UI avancée et performance
  • 16Fuites mémoire : les trouver et les corrigerAbonnements, timers et listeners qui survivent à leur composant — comment les repérer dans les DevTools et les fermer.UI avancée et performance
  • 17Sécurité : XSS, sanitisation et CSPCe qu’Angular fait automatiquement contre le XSS, quand bypassSecurityTrust devient dangereux, plus la CSP avec nonce, Trusted Types et XSRF.Sécurité et internationalisation
  • 17Authentification : tokens et refreshUn interceptor qui ajoute le token, le renouvelle une seule fois sur une 401 et rejoue les requêtes en attente — plus où conserver le token.Sécurité et internationalisation
  • 17OAuth 2.1 et OpenID Connect avec PKCELe flux authorization code avec PKCE, pas à pas : verifier et challenge, state et nonce, l’ID token, et pourquoi un BFF est plus sûr.Sécurité et internationalisation
  • 17Internationalisation (i18n)$localize, l’attribut i18n, ICU plural/select, un build par langue vs des traductions à l’exécution, et le formatage selon la locale.Sécurité et internationalisation