深色模式
深色在先,浅色靠一个 prop,开关则看你在哪种宿主上。
身份是深色的。:root 握着深色调色板,.light 选择退出。这和大多数样式表相反,而且是故意的:一个页面挂上根、别的什么都不说,出来的是品牌的底,不是白底。
由根来决定
import { Hanzo } from '@hanzo/ui'
<Hanzo theme="light">{children}</Hanzo>整个 API 就是 theme。根在 body 上盖下 .t_light 或 .t_dark,每个令牌都对着那个主题解析,样式表的自定义属性也应答同一个类。宿主若想把选择交给一个人,就把它放在 state 里,再交给根。
一个开关
来自 @hanzo/ui/product 的 ThemeToggle 画出按钮,并报告下一个主题。受控时,它是根旁边的一行。
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 渲染出来的那个。