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] }));
},
})),
);
withState()crée un signal par tranche d'état (store.lignes).withComputed()ajoute des valeurs dérivées (store.total).withMethods()ajoute des méthodes ; elles modifient l'état avecpatchState().
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/signalsqui 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)oupatchState(store, etat => partiel). Par défaut, l'état est protégé : seul le code du store lui-même (danswithMethods) 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 »).
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.