@hanzo/ui

Тёмная тема

Сначала тёмная, светлая — одним пропом, и переключатель для того хоста, на котором вы сидите.

Идентичность тёмная. :root держит тёмную палитру, а .light из неё выходит — наоборот относительно большинства таблиц стилей, и это нарочно: страница, которая монтирует корень и больше ничего не говорит, выходит на фоне бренда, а не на белом.

Решает корень

import { Hanzo } from '@hanzo/ui'

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

theme — весь API. Корень ставит на body .t_light или .t_dark, каждый токен разрешается относительно этой темы, и пользовательские свойства таблицы отвечают на тот же класс. Хост, который хочет оставить выбор человеку, держит его в состоянии и отдаёт корню.

Переключатель

ThemeToggle из @hanzo/ui/product рисует кнопку и сообщает следующую тему. В управляемом режиме это одна строка рядом с корнем:

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 на самом элементе документа и помнит выбор под ключом theme в localStorage, для хоста, которому негде держать состояние. В обоих случаях он показывает цель: солнце в тёмной теме, луна в светлой.

Next

Хосты на Next уже запускают @hanzogui/next-theme, и привязка переключателя к нему лежит на собственном subpath, чтобы никакой другой хост не затащил Next в граф, импортируя слой продукта.

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

<ThemeToggleNext />

<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 пишут его из встроенного скрипта; переключатель, написанный вручную, должен делать то же. Поставьте suppressHydrationWarning на элемент html: класс, который записал скрипт, — не тот, который отрендерил React.