Bonnes pratiques Next.js
Principes pour le développement avec le Next.js App Router.
1. Composants serveur vs client
Arbre de décision
L'élément a besoin...?
│
├── useState, useEffect, gestionnaires d'événements
│ └── Composant client ('use client')
│
├── Récupération directe de données, aucune interactivité
│ └── Composant serveur (par défaut)
│
└── Les deux ?
└── Séparer : parent serveur + enfant client
Par défaut
| Type | Utilisation |
|---|
| Serveur | Récupération de données, mise en page, contenu statique |
| Client | Formulaires, boutons, UI interactive |
2. Schémas de récupération de données
Stratégie de récupération
| Schéma | Utilisation |
|---|
| Par défaut | Statique (mis en cache à la construction) |
| Revalidate | ISR (rafraîchissement basé sur le temps) |
| No-store | Dynamique (chaque requête) |
Flux de données
| Source | Schéma |
|---|
| Base de données | Récupération dans un composant serveur |
| API | fetch avec mise en cache |
| Saisie utilisateur | État client + action serveur |
3. Principes de routage
Conventions de fichiers
| Fichier | Objectif |
|---|
page.tsx | UI de la route |
layout.tsx | Mise en page partagée |
loading.tsx | État de chargement |
error.tsx | Limite d'erreur |
not-found.tsx | Page 404 |
Organisation des routes
| Schéma | Utilisation |
|---|
Groupes de routes (nom) | Organiser sans modifier l'URL |
Routes parallèles @slot | Plusieurs pages au même niveau |
Interception (.) | Superpositions modales |
4. Routes API
Gestionnaires de route
| Méthode | Utilisation |
|---|
| GET | Lire des données |
| POST | Créer des données |
| PUT/PATCH | Mettre à jour des données |
| DELETE | Supprimer des données |
Bonnes pratiques
- Valider les entrées avec Zod
- Retourner des codes de statut appropriés
- Gérer les erreurs avec grâce
- Utiliser le runtime Edge lorsque c'est possible
5. Principes de performance
Optimisation des images
- Utiliser le composant next/image
- Définir la priorité pour le contenu au-dessus de la ligne de flottaison
- Fournir un espace réservé flou
- Utiliser des tailles responsives
Optimisation du bundle
- Imports dynamiques pour les composants lourds
- Division de code basée sur les routes (automatique)
- Analyser avec l'analyseur de bundle
6. Métadonnées
Statique vs dynamique
| Type | Utilisation |
|---|
| Export statique | Métadonnées fixes |
| generateMetadata | Dynamique par route |
Balises essentielles
- title (50-60 caractères)
- description (150-160 caractères)
- Images Open Graph
- URL canonique
7. Stratégie de mise en cache
Couches de cache
| Couche | Contrôle |
|---|
| Requête | options de fetch |
| Données | revalidate/tags |
| Route complète | configuration de route |
Revalidation
| Méthode | Utilisation |
|---|
| Basée sur le temps | revalidate: 60 |
| À la demande | revalidatePath/Tag |
| Sans cache | no-store |
8. Actions serveur
Cas d'utilisation
- Soumissions de formulaires
- Mutations de données
- Déclencheurs de revalidation
Bonnes pratiques
- Marquer avec 'use server'
- Valider toutes les entrées
- Retourner des réponses typées
- Gérer les erreurs
9. Anti-patrons
| ❌ À éviter | ✅ À faire |
|---|
| 'use client' partout | Serveur par défaut |
| Récupérer dans les composants client | Récupérer dans le serveur |
| Ignorer les états de chargement | Utiliser loading.tsx |
| Ignorer les limites d'erreur | Utiliser error.tsx |
| Gros bundles client | Imports dynamiques |
10. Structure du projet
app/
├── (marketing)/ # Groupe de routes
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # Mise en page du tableau de bord
│ └── page.tsx
├── api/
│ └── [ressource]/
│ └── route.ts
└── components/
└── ui/
Rappel : Les composants serveur sont le choix par défaut pour une bonne raison. Commencez par là, ajoutez du client uniquement lorsque c'est nécessaire.
Quand utiliser
Cette compétence est applicable pour exécuter le workflow ou les actions décrits dans l'aperçu.
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une révision experte spécifique à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.