Stratégies de rendu (App Router)
Priorité : P0 (CRITIQUE)
Choisissez la stratégie de rendu en fonction de la fraîcheur des données et des besoins de passage à l'échelle. Voir la matrice de stratégie.
Directives d'implémentation
- SSG (Génération de site statique) : Par défaut pour l'App Router. Utilisez
generateStaticParamspour pré-rendre les routes au moment de la construction. Déclenché parfetchaveccache: 'force-cache'. - SSR (Rendu côté serveur) : Déclenché par
cookies(),headers(), oufetchaveccache: 'no-store'. À utiliser pour des données personnalisées ou très fraîches. - ISR (Régénération statique incrémentielle) : Mettez à jour le contenu statique après la construction. Utilisez
revalidate(basé sur le temps) ourevalidatePath/revalidateTag(à la demande). - Streaming : Utilisez
Suspensepour encapsuler les composants asynchrones lents et éviter qu'ils ne bloquent le chargement initial de la page. Utilisezloading.tsxpour les squelettes au niveau de la route. - PPR (Prerendering partiel) : Combinez une coque statique avec des régions dynamiques en une seule requête HTTP. Activez
ppr: truedansnext.config.js. - Stratégies : Choisissez le rendu en fonction du SEO (SSG/ISR) vs Interactivité (Client) vs Personnalisation (SSR). Utilisez
dynamicParamspour contrôler le comportement de repli pour les routes non mises en cache. - Hydratation : Évitez les erreurs d'hydratation en n'utilisant pas de valeurs propres au navigateur (
window.innerWidth,Date.now()) dans le rendu initial. Utilisez le modèle useEffect avecmounted. - Runtime Edge : Utilisez
runtime: 'edge'pour une exécution à faible latence répartie mondialement lorsque les API Node.js complètes ne sont pas nécessaires.
Anti-patrons
- Pas d'attente racine dans
page.tsx: Encapsulez les composants lents dans<Suspense>pour les streamer. - Pas de SSR pour du contenu statique : Utilisez SSG ou ISR ; réservez le SSR pour les données véritablement dynamiques.
- Pas de
typeof windowdans le rendu initial : UtilisezuseEffectpour éviter les erreurs d'hydratation.