文档
Next.js

Next.js

为你的 Next 应用添加暗黑模式。

暗黑模式

安装 next-themes

首先安装 next-themes

pnpm add next-themes

创建主题提供器

components/theme-provider.tsx
"use client"
 
import * as React from "react"
import { ThemeProvider as NextThemesProvider } from "next-themes"
 
export function ThemeProvider({
  children,
  ...props
}: React.ComponentProps<typeof NextThemesProvider>) {
  return <NextThemesProvider {...props}>{children}</NextThemesProvider>
}

包裹你的根布局

将 ThemeProvider 添加到你的根布局，并将 suppressHydrationWarning 属性添加到 html 标签。

app/layout.tsx
import { ThemeProvider } from "@/components/theme-provider"
 
export default function RootLayout({ children }: RootLayoutProps) {
  return (
    <>
      <html lang="en" suppressHydrationWarning>
        <head />
        <body>
          <ThemeProvider
            attribute="class"
            defaultTheme="system"
            enableSystem
            disableTransitionOnChange
          >
            {children}
          </ThemeProvider>
        </body>
      </html>
    </>
  )
}

添加模式切换

在你的网站上放置一个模式切换按钮，以便在浅色和深色模式之间切换。