@hanzo/ui

Chế độ tối

Tối trước, sáng bằng một prop, và một nút chuyển cho host nào bạn đang dùng.

Bản sắc là tối. :root giữ bảng màu tối và .light chọn ra khỏi đó, ngược với hầu hết bảng kiểu, và đó là chủ đích: trang gắn gốc rồi không nói gì khác ra trên nền của thương hiệu, không phải trên trắng.

Gốc quyết định

import { Hanzo } from '@hanzo/ui'

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

theme là toàn bộ API. Gốc đóng dấu .t_light hoặc .t_dark lên body, mọi token phân giải theo chủ đề đó, và thuộc tính tùy biến của bảng kiểu trả lời cùng lớp ấy. Host muốn lựa chọn thuộc về một người thì giữ nó trong state rồi đưa cho gốc.

Một nút chuyển

ThemeToggle từ @hanzo/ui/product vẽ nút và báo chủ đề kế tiếp. Khi được điều khiển, nó là một dòng cạnh gốc:

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

Không điều khiển — <ThemeToggle onThemeChange={fn} /> — nó tự bật tắt lớp .dark và .light trên phần tử tài liệu và nhớ lựa chọn dưới khóa theme trong localStorage, cho host không có state để giữ. Cách nào nó cũng chỉ đích: mặt trời khi tối, mặt trăng khi sáng.

Next

Các host Next đã chạy @hanzogui/next-theme, và phần buộc của nút chuyển tới nó nằm ở đường con riêng để host khác không kéo Next vào đồ thị chỉ vì nhập lớp sản phẩm.

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

<ThemeToggleNext />

<ThemeToggle /> không có prop nào cũng tới cùng phần buộc ấy bằng nhập động và lùi về nút chuyển trên tài liệu ở nơi phần buộc vắng.

One và Vite

Trang này giữ lựa chọn với @vxrn/color-scheme, vốn chốt sơ đồ đã lưu trước lần vẽ đầu và báo nó cho gốc:

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 cũng mở setting — system, dark hoặc light — và set, thứ mà nút chuyển ở đầu trang này điều khiển.

Không nháy

Host nào cũng vậy, lớp chủ đề phải có trên tài liệu trước khi bảng kiểu vẽ, không thì trang vẽ tối rồi vẽ lại sáng. Phần buộc Next và @vxrn/color-scheme đều ghi nó từ một script nội tuyến; nút chuyển viết tay cũng nên làm vậy. Đặt suppressHydrationWarning trên phần tử html, vì lớp mà script đã viết không phải lớp React đã dựng.