@hanzo/ui

ダークモード

まずダーク。ライトは 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 が描画したものではないからです。