@hanzo/ui

Modo escuro

Escuro primeiro, claro por uma prop, e um alternador para o host em que você estiver.

A identidade é escura. :root guarda a paleta escura e .light sai dela, o contrário da maioria das folhas de estilos, e é de propósito: uma página que monta a raiz e não diz mais nada sai no fundo da marca, não no branco.

A raiz decide

import { Hanzo } from '@hanzo/ui'

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

theme é a API inteira. A raiz carimba .t_light ou .t_dark no body, cada token resolve contra esse tema, e as propriedades personalizadas da folha de estilos respondem à mesma classe. Um host que quer que a escolha seja de uma pessoa a guarda no estado e a entrega à raiz.

Um alternador

ThemeToggle de @hanzo/ui/product desenha o botão e informa o próximo tema. Controlado, é uma linha ao lado da raiz:

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

Sem controle — <ThemeToggle onThemeChange={fn} /> — ele alterna as classes .dark e .light no próprio elemento do documento e lembra a escolha sob a chave theme no localStorage, para um host que não tem estado onde guardá-la. De um jeito ou de outro ele mostra o alvo: um sol no modo escuro, uma lua no claro.

Next

Hosts Next já rodam @hanzogui/next-theme, e o binding do alternador com ele fica no próprio subpath para que nenhum outro host puxe o Next para o grafo ao importar a camada de produto.

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

<ThemeToggleNext />

<ThemeToggle /> sem prop nenhuma alcança o mesmo binding por import dinâmico e cai no alternador do documento onde ele não existe.

One e Vite

Este site guarda a escolha com @vxrn/color-scheme, que resolve o esquema guardado antes da primeira pintura e o informa à raiz:

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 também expõe setting — system, dark ou light — e set, que é o que o alternador no cabeçalho deste site aciona.

Sem flash

Em qualquer host, a classe de tema tem de estar no documento antes de a folha pintar, senão a página pinta escura e repinta clara. O binding do Next e @vxrn/color-scheme escrevem os dois a partir de um script inline; um alternador escrito à mão deve fazer o mesmo. Coloque suppressHydrationWarning no elemento html, já que a classe que o script escreveu não é a que o React renderizou.