Mode Sombre
Règles
- Utilisez
next-themes pour les applications Next.js — enveloppez l'application dans <ThemeProvider attribute="class" defaultTheme="system">
- Variables CSS pour les couleurs — définissez dans
:root (clair) et .dark (sombre), référencez comme var(--background)
- Détection des préférences système :
defaultTheme="system" respecte la media query prefers-color-scheme
- Composant de bascule de thème : cycle entre clair/sombre/système — utilisez le hook
useTheme() de next-themes
- Intégration Tailwind : activez
darkMode: "class" dans la configuration tailwind, utilisez le préfixe dark: pour les surcharges
- Correction d'hydratation : supprimez les erreurs d'hydratation en montant le bouton de thème uniquement après
useEffect ou en utilisant suppressHydrationWarning
- Persistance :
next-themes stocke la préférence dans localStorage et l'applique comme une classe sur <html>
- Transition : ajoutez
transition-colors duration-200 au body pour un changement de thème fluide
Modèles
import { ThemeProvider } from "next-themes";
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="fr" suppressHydrationWarning>
<body>
<ThemeProvider attribute="class" defaultTheme="system" enableSystem>
{children}
</ThemeProvider>
</body>
</html>
);
}
"use client";
import { useTheme } from "next-themes";
import { useEffect, useState } from "react";
export function ThemeToggle() {
const { theme, setTheme } = useTheme();
const [mounted, setMounted] = useState(false);
useEffect(() => setMounted(true), []);
if (!mounted) return null;
return (
<button onClick={() => setTheme(theme === "dark" ? "light" : "dark")}>
{theme === "dark" ? "☀️" : "🌙"}
</button>
);
}
:root {
--background: 0 0% 100%;
--foreground: 222.2 84% 4.9%;
}
.dark {
--background: 222.2 84% 4.9%;
--foreground: 210 40% 98%;
}
À éviter
- Coder en dur des couleurs au lieu de variables CSS — rend le theming impossible
- Oublier
suppressHydrationWarning sur <html> — provoque des erreurs d'hydratation
- Flash du mauvais thème : assurez-vous que le script
next-themes s'exécute avant le rendu (c'est le cas par défaut)
- Ne supporter que clair/sombre sans option système — respectez la préférence OS de l'utilisateur