@hanzo/ui

深色模式

先是深色。要淺色,一個 prop 就夠。開關則跟著你所在的宿主走。

這套身份以深色為準。深色調色盤放在 :root,.light 才是退出。多數樣式表反過來做,這裡是刻意的:頁面只掛上根、其他什麼都不講,畫出來的是品牌的底色,不是一片白。

根說了算

import { Hanzo } from '@hanzo/ui'

<Hanzo theme="light">{children}</Hanzo>

theme 就是全部的 API。根會在 body 蓋上 .t_light 或 .t_dark,每個權杖都對著那個主題解析,樣式表裡的自訂屬性也認同一個類別。宿主若要把選擇留給人,就放進 state,再交給根。

開關

ThemeToggle 來自 @hanzo/ui/product。它畫出按鈕,並把下一個主題回報出來。受控的時候,它就是根旁邊的一行。

import { useState } from 'react'
import { Hanzo } from '@hanzo/ui'
import { ThemeToggle, type ThemeMode } from '@hanzo/ui/product'

export function App({ children }) {
  const [theme, setTheme] = useState<ThemeMode>('dark')
  return (
    <Hanzo theme={theme}>
      <ThemeToggle theme={theme} onToggle={setTheme} />
      {children}
    </Hanzo>
  )
}

沒有受控時,<ThemeToggle onThemeChange={fn} /> 會在文件元素自己身上切換 .dark 與 .light,並把選擇記在 localStorage 的 theme 鍵。這是給沒有 state 可放的宿主。兩種做法顯示的都是將要去的那一側:深色時是太陽,淺色時是月亮。

Next

Next 的宿主本來就在跑 @hanzogui/next-theme。開關對它的繫結放在自己的子路徑,免得其他宿主一匯入產品層,就把 Next 拉進相依圖。

import { ThemeToggleNext } from '@hanzo/ui/product/theme-toggle-next'

<ThemeToggleNext />

完全不給 props 的 <ThemeToggle /> 會用動態匯入摸到同一條繫結;那裡沒有這條繫結時,就退回文件上的開關。

One 與 Vite

這個網站把選擇交給 @vxrn/color-scheme。存好的方案會在第一次繪製之前定下來,再回報給根:

import { Hanzo } from '@hanzo/ui'
import { SchemeProvider, useUserScheme } from '@vxrn/color-scheme'

function Site({ children }) {
  const { value } = useUserScheme()
  return <Hanzo theme={value}>{children}</Hanzo>
}

export default function Layout({ children }) {
  return (
    <SchemeProvider defaultScheme="dark">
      <Site>{children}</Site>
    </SchemeProvider>
  )
}

useUserScheme 另外露出 setting,也就是 system、dark 或 light,以及 set。本站頁首的開關驅動的就是這個。

別讓它閃一下

不論哪一種宿主,主題類別都得在樣式表上色之前就在文件上。否則頁面會先塗深色,再改塗淺色。Next 的繫結和 @vxrn/color-scheme 都用一段內嵌指令碼寫上;手寫的開關也該這樣。請在 html 元素放上 suppressHydrationWarning,因為指令碼寫下的類別,不是 React 繪製出來的那個。