Formations — 1 037 leçons en français

Accueil › Angular › NgRx SignalStore (aperçu)

NgRx SignalStore (aperçu)

Gestion d'étatintermediaire

Un service à signaux (leçon précédente) couvre la plupart des besoins d'état. NgRx SignalStore (package @ngrx/signals) devient intéressant quand on veut une structure imposée et cohérente entre plusieurs fonctionnalités ou équipes, avec des outils de développement associés — pas parce qu'un service maison serait insuffisant en soi.

Un SignalStore se construit en combinant des features :

import { computed } from '@angular/core';
import { signalStore, withState, withComputed, withMethods, patchState } from '@ngrx/signals';

type PanierState = {
  lignes: LigneCommande[];
};

export const PanierStore = signalStore(
  { providedIn: 'root' },
  withState<PanierState>({ lignes: [] }),
  withComputed(({ lignes }) => ({
    total: computed(() => lignes().reduce((s, l) => s + l.prix * l.quantite, 0)),
  })),
  withMethods((store) => ({
    ajouter(ligne: LigneCommande): void {
      patchState(store, (state) => ({ lignes: [...state.lignes, ligne] }));
    },
  })),
);

Par défaut, l'état est protégé : un composant ne peut lire que les signaux exposés, jamais appeler patchState() lui-même — toute modification passe par une méthode du store.

Les termes à connaître

signalStore()

Fonction du package @ngrx/signals qui construit un store en combinant des features (withState, withComputed, withMethods…). Elle renvoie une classe injectable : à fournir (providers) avant de l'injecter, ou à créer directement avec { providedIn: 'root' }.

withState()

Feature qui ajoute des tranches d'état au store à partir d'un objet initial. Un signal est créé automatiquement pour chaque propriété (et pour les propriétés imbriquées, en DeepSignal).

withComputed()

Feature qui ajoute des signaux dérivés (Signal<T>) au store, calculés à partir de l'état et des propriétés déjà définies par les features précédentes.

withMethods()

Feature qui ajoute des méthodes au store (mise à jour d'état, effets de bord synchrones ou asynchrones). Sa fonction fabrique reçoit l'instance du store et s'exécute dans le contexte d'injection : inject() y est utilisable.

patchState()

Fonction pour modifier l'état d'un store : patchState(store, partiel) ou patchState(store, etat => partiel). Par défaut, l'état est protégé : seul le code du store lui-même (dans withMethods) peut l'appeler, pas un composant consommateur.

withHooks()

Feature pour exécuter du code à l'initialisation (onInit) ou à la destruction (onDestroy) du store — par exemple démarrer un chargement initial ou nettoyer une souscription.

NgRx Store (classique)

La librairie NgRx historique, basée sur des actions, des reducers purs, des effects (side effects en RxJS) et des selectors — le pattern Redux appliqué à Angular. Plus structurée et outillée que SignalStore, mais avec davantage de code de structure (« boilerplate »).

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.