Modalità scura
Scuro prima, chiaro con una prop, e un interruttore per l'host su cui ti trovi.
L’identità è scura. :root tiene la palette scura e .light se ne esce, al
contrario della maggior parte dei fogli, ed è voluto: una pagina che monta la
radice e non dice altro esce sul fondo del marchio, non sul bianco.
Decide la radice
import { Hanzo } from '@hanzo/ui'
<Hanzo theme="light">{children}</Hanzo>theme è tutta l’API. La radice mette .t_light o .t_dark sul body, ogni
token si risolve contro quel tema, e le proprietà personalizzate del foglio
rispondono alla stessa classe. Un host che vuole che la scelta sia di una
persona la tiene nello stato e la consegna alla radice.
Un interruttore
ThemeToggle, da @hanzo/ui/product, disegna il pulsante e annuncia il tema
successivo. Controllato, è una riga accanto alla radice:
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 controllato — <ThemeToggle onThemeChange={fn} /> — alterna le classi
.dark e .light sull’elemento del documento stesso e ricorda la scelta
sotto la chiave theme in localStorage, per un host che non ha uno stato in
cui tenerla. In entrambi i casi mostra la meta: un sole nello scuro, una luna
nel chiaro.
Next
Gli host Next fanno già girare @hanzogui/next-theme, e il legame
dell’interruttore con esso sta su un subpath proprio, così nessun altro host
si tira dentro Next nel grafo importando lo strato di prodotto.
import { ThemeToggleNext } from '@hanzo/ui/product/theme-toggle-next'
<ThemeToggleNext /><ThemeToggle /> senza alcuna prop raggiunge lo stesso legame per import
dinamico e, dove manca, ricade sull’interruttore del documento.
One e Vite
Questo sito tiene la scelta con @vxrn/color-scheme, che sistema lo schema
salvato prima del primo paint e lo riferisce alla radice:
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 espone anche setting — system, dark o light — e
set, che è ciò che muove l’interruttore nell’intestazione di questo sito.
Niente lampo
Qualunque sia l’host, la classe del tema deve stare sul documento prima che il
foglio dipinga, altrimenti la pagina dipinge scura e si ridipinge chiara. Il
legame di Next e @vxrn/color-scheme la scrivono entrambi da uno script in
linea; un interruttore scritto a mano dovrebbe fare lo stesso. Metti
suppressHydrationWarning sull’elemento html, perché la classe che ha
scritto lo script non è quella che ha renderizzato React.