Que fait Gestion d'état ?
Priorité : P2 (MOYENNE)
Directives d'implémentation
- État URL : Utilisez l'URL comme source unique de vérité pour l'état partageable/persistant. Paramètres d'URL : partageables entre rechargements et liens. Accès via
useSearchParams()et mise à jour avecuseRouter(). Modèle :const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - État serveur : Utilisez SWR ou TanStack Query (React Query) pour la mise en cache et la récupération des données serveur. Évitez de synchroniser manuellement les données serveur dans
useState. - État client : Utilisez Zustand (
create<CartState>()((set) => ({ ... }))) — à utiliser uniquement dans les composants 'use client' — ou Jotai pour l'état UI complexe et à haute fréquence. Évitez le Prop Drilling en utilisant l'API Context uniquement pour les données à basse fréquence. - Remontée d'état : Colocalisez l'état le plus près possible du composant. Ne le remontez au parent que lorsque l'état est partagé entre des composants frères.
- Intégration Next.js 15+ : Assurez-vous que les mises à jour d'état dans les composants clients n'entrent pas en conflit avec la logique de rendu côté serveur. Gérez les mises à jour optimistes avec le hook
useOptimistic. - Hydratation d'état : Soyez prudent lors de l'initialisation de l'état à partir de
localStoragedans les composants clients pour éviter les erreurs d'hydratation. Enveloppez dansuseEffectou utilisez un indicateurmounted.
2. État piloté par l'URL (Recherche/Filtre)
Utilisez useSearchParams + useRouter pour mettre à jour les paramètres d'URL. Voir Modèle d'état URL.
3. État serveur (TanStack Query / SWR)
Si vous avez besoin de données « en direct » sur le client (par exemple, cours d'actions en polling, chat), n'implémentez pas manuellement la récupération avec useEffect. Utilisez une bibliothèque.
// Mise en cache, déduplication et revalidation automatisées avec refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
Modèles de bibliothèques
Pour des modèles spécifiques de gestion d'état, voir :
Anti-patrons
- Pas de store global pour un état simple : Utilisez
useStateou des paramètres d'URL ; évitez Zustand pour une UI basique. - Pas de gros objets dans l'état : Décomposez en primitives granulaires pour éviter les re-rendus supplémentaires.
- Pas de
useEffectpour la récupération de données : Utilisez SWR ou TanStack Query pour l'état serveur. - Pas d'état serveur dans les stores clients : Récupérez dans les RSC ; les stores clients sont uniquement pour l'état UI.