Docs
Remix

Remix

为你的 remix 应用程序添加深色模式。

深色模式

步骤

修改你 的 tailwind.css 文件

将 :root[class~="dark"] 加入到你的 tailwind.css 文件中，该方式允许你在你的 html 元素上使用 dark 类名，以便于使用深色模式样式。

app/tailwind.css
.dark,
:root[class~="dark"] {
  ...;
}

安装 remix-themes

首先，安装 remix-themes:

npm install remix-themes

创建一个会话储存和主题会话解析

app/sessions.server.tsx
import { createThemeSessionResolver } from "remix-themes"
 
// 如果你未设置 process.env.NODE_ENV，你可以在此处选择 'development'
const isProduction = process.env.NODE_ENV === "production"
 
const sessionStorage = createCookieSessionStorage({
  cookie: {
    name: "theme",
    path: "/",
    httpOnly: true,
    sameSite: "lax",
    secrets: ["s3cr3t"],
    // 仅在生产模式中设置域及安全模式
    ...(isProduction
      ? { domain: "your-production-domain.com", secure: true }
      : {}),
  },
})
 
export const themeSessionResolver = createThemeSessionResolver(sessionStorage)

设置 Remix 主题

将 ThemeProvider 添加到你的根布局中。

app/root.tsx
import clsx from "clsx"
import { PreventFlashOnWrongTheme, ThemeProvider, useTheme } from "remix-themes"
 
import { themeSessionResolver } from "./sessions.server"
 
// 使用 loader 从会话储存中返回主题
export async function loader({ request }: LoaderFunctionArgs) {
  const { getTheme } = await themeSessionResolver(request)
  return {
    theme: getTheme(),
  }
}
// 使用 ThemeProvider 包装你的应用程序。
// `specifiedTheme` 是会话储存中储存的主题。
// `themeAction` 是在会话储存中用来更改主题的动作名。
export default function AppWithProviders() {
  const data = useLoaderData<typeof loader>()
  return (
    <ThemeProvider specifiedTheme={data.theme} themeAction="/action/set-theme">
      <App />
    </ThemeProvider>
  )
}
 
export function App() {
  const data = useLoaderData<typeof loader>()
  const [theme] = useTheme()
  return (
    <html lang="en" className={clsx(theme)}>
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
        <Meta />
        <PreventFlashOnWrongTheme ssrTheme={Boolean(data.theme)} />
        <Links />
      </head>
      <body>
        <Outlet />
        <ScrollRestoration />
        <Scripts />
        <LiveReload />
      </body>
    </html>
  )
}

添加一个操作路由

在 /routes/action.set-theme.ts 中创建一个文件。确保将文件名传递给 ThemeProvider 组件。该路由用于在用户进行更改时 将首选主题储存到会话储存中。

app/routes/action.set-theme.ts
import { createThemeAction } from "remix-themes"
 
import { themeSessionResolver } from "./sessions.server"
 
export const action = createThemeAction(themeSessionResolver)

添加一个模式切换

在你的网站中放置一个模式切换，用于在明暗模式之间切换。

components/mode-toggle.tsx
import { Moon, Sun } from "lucide-react"
import { Theme, useTheme } from "remix-themes"
 
import { Button } from "./ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuTrigger,
} from "./ui/dropdown-menu"
 
export function ModeToggle() {
  const [, setTheme] = useTheme()
 
  return (
    <DropdownMenu>
      <DropdownMenuTrigger asChild>
        <Button variant="ghost" size="icon">
          <Sun className="h-[1.2rem] w-[1.2rem] rotate-0 scale-100 transition-all dark:-rotate-90 dark:scale-0" />
          <Moon className="absolute h-[1.2rem] w-[1.2rem] rotate-90 scale-0 transition-all dark:rotate-0 dark:scale-100" />
          <span className="sr-only">切换主题</span>
        </Button>
      </DropdownMenuTrigger>
      <DropdownMenuContent align="end">
        <DropdownMenuItem onClick={() => setTheme(Theme.LIGHT)}>
          浅色模式
        </DropdownMenuItem>
        <DropdownMenuItem onClick={() => setTheme(Theme.DARK)}>
          深色模式
        </DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
  )
}