ダークモード は何をしますか?
ルール
- Next.jsアプリでは
next-themes を使用する — アプリを <ThemeProvider attribute="class" defaultTheme="system"> でラップする
- 色の定義にはCSS変数を使用する —
:root(ライト)と .dark(ダーク)に定義し、var(--background) で参照する
- システム設定の検出:
defaultTheme="system" により prefers-color-scheme メディアクエリを尊重する
- テーマトグルコンポーネント: ライト/ダーク/システムを切り替える —
next-themes の useTheme() フックを使用する
- Tailwind統合: tailwind設定で
darkMode: "class" を有効にし、オーバーライドには dark: プレフィックスを使用する
- ハイドレーション修正:
useEffect の後にテーマトグルをマウントするか、suppressHydrationWarning を使用してハイドレーションの不一致を防ぐ
- 永続化:
next-themes は設定を localStorage に保存し、<html> に class として適用する
- トランジション: スムーズなテーマ切り替えのために body に
transition-colors duration-200 を追加する
パターン
import { ThemeProvider } from "next-themes";
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" 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%;
}
避けるべきこと
- CSS変数ではなく色をハードコーディングする — テーマ設定が不可能になる
<html> に suppressHydrationWarning を付け忘れる — ハイドレーションエラーの原因になる
- テーマの誤表示:
next-themes のスクリプトが描画前に実行されることを確認する(デフォルトで実施済み)
- システムオプションなしでライト/ダークのみをサポートする — ユーザーのOS設定を尊重する