@hanzo/ui

Mode sombre

Sombre d'abord, clair par une prop, et une bascule pour l'hôte sur lequel vous êtes.

L’identité est sombre. :root tient la palette sombre et .light s’en retire, à l’inverse de la plupart des feuilles, et c’est voulu : une page qui monte la racine et ne dit rien d’autre sort sur le fond de la marque, pas sur du blanc.

La racine décide

import { Hanzo } from '@hanzo/ui'

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

theme est toute l’API. La racine pose .t_light ou .t_dark sur le body, chaque token se résout sur ce thème, et les propriétés personnalisées de la feuille répondent à la même classe. Un hôte qui veut que le choix soit celui d’une personne le garde dans l’état et le remet à la racine.

Une bascule

ThemeToggle, depuis @hanzo/ui/product, dessine le bouton et annonce le thème suivant. Contrôlée, c’est une ligne à côté de la racine :

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

Non contrôlée — <ThemeToggle onThemeChange={fn} /> — elle bascule les classes .dark et .light sur l’élément du document lui-même et retient le choix sous la clé theme dans localStorage, pour un hôte qui n’a pas d’état où le garder. Dans les deux cas elle montre la cible : un soleil en sombre, une lune en clair.

Next

Les hôtes Next font déjà tourner @hanzogui/next-theme, et la liaison de la bascule avec lui est sur son propre subpath, pour qu’aucun autre hôte n’entraîne Next dans son graphe en important la couche produit.

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

<ThemeToggleNext />

<ThemeToggle /> sans aucune prop atteint la même liaison par import dynamique et retombe sur la bascule du document là où elle est absente.

One et Vite

Ce site garde le choix avec @vxrn/color-scheme, qui fixe le schéma enregistré avant le premier affichage et le rapporte à la racine :

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 expose aussi setting — system, dark ou light — et set, qui est ce que commande la bascule dans l’en-tête de ce site.

Pas de flash

Quel que soit l’hôte, la classe de thème doit être sur le document avant que la feuille ne peigne, sinon la page peint en sombre et repeint en clair. La liaison Next et @vxrn/color-scheme l’écrivent toutes les deux depuis un script en ligne ; une bascule écrite à la main doit faire de même. Mettez suppressHydrationWarning sur l’élément html, puisque la classe écrite par le script n’est pas celle que React a rendue.