@hanzo/ui

Mode gelap

Gelap lebih dulu, terang lewat satu prop, dan sebuah pengalih untuk host mana pun yang Anda pakai.

Identitasnya gelap. :root memegang palet gelap dan .light memilih keluar, kebalikan dari kebanyakan lembar gaya, dan itu disengaja: halaman yang memasang akar dan tidak mengatakan apa pun lagi tampil di dasar merek, bukan di putih.

Akar yang memutuskan

import { Hanzo } from '@hanzo/ui'

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

theme adalah seluruh API. Akar menstempel .t_light atau .t_dark pada body, setiap token diselesaikan terhadap tema itu, dan properti kustom lembar gaya menjawab kelas yang sama. Host yang ingin pilihan itu milik seseorang menyimpannya di state lalu menyerahkannya ke akar.

Sebuah pengalih

ThemeToggle dari @hanzo/ui/product menggambar tombol dan melaporkan tema berikutnya. Saat dikendalikan, ia satu baris di samping akar:

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

Tanpa kendali — <ThemeToggle onThemeChange={fn} /> — ia mengalihkan kelas .dark dan .light pada elemen dokumen sendiri dan mengingat pilihan di bawah kunci theme dalam localStorage, untuk host yang tidak punya state untuk menyimpannya. Bagaimanapun ia menunjukkan sasaran: matahari di mode gelap, bulan di mode terang.

Next

Host Next sudah menjalankan @hanzogui/next-theme, dan pengikatan pengalih ke situ tinggal di subpath sendiri agar host lain tidak menarik Next ke dalam grafnya dengan mengimpor lapisan produk.

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

<ThemeToggleNext />

<ThemeToggle /> tanpa prop sama sekali mencapai pengikatan yang sama lewat impor dinamis dan jatuh kembali ke pengalih dokumen bila pengikatan itu tidak ada.

One dan Vite

Situs ini menyimpan pilihan bersama @vxrn/color-scheme, yang menetapkan skema tersimpan sebelum cat pertama dan melaporkannya ke akar:

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 juga membuka setting — system, dark, atau light — dan set, yang digerakkan pengalih di header situs ini.

Tanpa kilatan

Host mana pun, kelas tema harus sudah ada pada dokumen sebelum lembar gaya mengecat, atau halaman mengecat gelap lalu mengecat ulang terang. Pengikatan Next dan @vxrn/color-scheme keduanya menuliskannya dari skrip inline; pengalih yang ditulis tangan sebaiknya melakukan hal yang sama. Letakkan suppressHydrationWarning pada elemen html, karena kelas yang ditulis skrip bukan kelas yang dirender React.