Bonnes pratiques Next.js
Principes pour le développement avec le routeur App de Next.js.
1. Composants serveur vs client
Arbre de décision
Est-ce que ça nécessite... ?
│
├── useState, useEffect, gestionnaires d'événements
│ └── Composant client ('use client')
│
├── Récupération de données directe, sans 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. Modèles de récupération de données
Stratégie de récupération
| Modèle | 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 | Modèle |
|---|
| 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
| Modèle | Utilisation |
|---|
Groupes de routes (nom) | Organiser sans URL |
Routes parallèles @slot | Plusieurs pages au même niveau |
Interception (.) | Superpositions modales |
4. Routes API
Gestionnaires de routes
| 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 élégance
- 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 par route (automatique)
- Analyser avec un analyseur de bundle
6. Métadonnées
Statique vs dynamique
| Type | Utilisation |
|---|
| Exportation 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 fetch |
| Données | revalidate/tags |
| Route complète | configuration de route |
Rafraîchissement
| Méthode | Utilisation |
|---|
| Basé sur le temps | revalidate: 60 |
| À la demande | revalidatePath/Tag |
| Pas de cache | no-store |
8. Actions serveur
Cas d'utilisation
- Soumissions de formulaires
- Mutations de données
- Déclenchements de rafraîchissement
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ération dans les composants client | Récupération 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/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
À retenir : Les composants serveur sont la valeur par défaut pour une bonne raison. Commencez par là, n'ajoutez le client que lorsque c'est nécessaire.