@hanzo/ui

Dunkelmodus

Dunkel zuerst, hell über eine Prop, und ein Schalter für den Host, auf dem du bist.

Die Identität ist dunkel. :root hält die dunkle Palette, und .light steigt aus, umgekehrt zu den meisten Stylesheets, und das ist Absicht: eine Seite, die die Wurzel einhängt und sonst nichts sagt, kommt auf dem Grund der Marke heraus, nicht auf Weiß.

Die Wurzel entscheidet

import { Hanzo } from '@hanzo/ui'

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

theme ist die ganze API. Die Wurzel setzt .t_light oder .t_dark auf den Body, jedes Token löst sich gegen dieses Theme auf, und die benutzerdefinierten Eigenschaften des Stylesheets antworten auf dieselbe Klasse. Ein Host, der die Wahl einer Person überlassen will, hält sie im State und reicht sie an die Wurzel.

Ein Schalter

ThemeToggle aus @hanzo/ui/product zeichnet den Button und meldet das nächste Theme. Gesteuert ist es eine Zeile neben der Wurzel:

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>
  )
}

Ungesteuert — <ThemeToggle onThemeChange={fn} /> — schaltet es die Klassen .dark und .light auf dem Dokumentelement selbst um und merkt sich die Wahl unter dem Schlüssel theme in localStorage, für einen Host, der keinen State hat, um sie zu halten. So oder so zeigt es das Ziel: eine Sonne im Dunklen, einen Mond im Hellen.

Next

Next-Hosts lassen @hanzogui/next-theme bereits laufen, und die Bindung des Schalters daran liegt auf einem eigenen Subpath, damit kein anderer Host Next in seinen Graphen zieht, nur weil er die Produktschicht importiert.

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

<ThemeToggleNext />

<ThemeToggle /> ganz ohne Props erreicht dieselbe Bindung per dynamischem Import und fällt dort, wo sie fehlt, auf den Dokument-Schalter zurück.

One und Vite

Diese Site hält die Wahl mit @vxrn/color-scheme, das das gespeicherte Schema vor dem ersten Paint festlegt und es der Wurzel meldet:

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 gibt auch setting heraus — system, dark oder light — und set, und genau das treibt der Schalter in der Kopfzeile dieser Site.

Kein Aufblitzen

Egal welcher Host: die Theme-Klasse muss auf dem Dokument stehen, bevor das Stylesheet zeichnet, sonst zeichnet die Seite dunkel und zeichnet hell neu. Die Next-Bindung und @vxrn/color-scheme schreiben sie beide aus einem Inline-Script; ein von Hand geschriebener Schalter sollte dasselbe tun. Setz suppressHydrationWarning auf das Element html, denn die Klasse, die das Script geschrieben hat, ist nicht die, die React gerendert hat.