@hanzo/ui

테마

토큰은 테마에 대해 풀리고, 커스텀 프로퍼티가 정체를 나르며, 세 개의 노브로 사람이 그 전체를 다시 맞출 수 있습니다.

라이브러리 안에서 색 이름을 적은 곳은 없습니다. 컴포넌트는 $background 나 $color12 를 구하고, 테마가 답합니다. 답은 다크와 라이트에서 다르고, 컴포넌트는 그것을 모릅니다. 브랜드는 커스텀 프로퍼티를 두어 답을 바꾸고, 사람은 램프가 곱하는 노브를 움직여 바꿉니다.

토큰

$ 로 시작하는 prop 값은 토큰입니다. 색 램프는 바닥에서 글자로 갑니다. $color1 이 가장 조용한 바닥이고, $color12 가 가장 큰 글자입니다.

토큰내용
$background페이지의 바닥. --background 를 읽으므로 브랜드의 스타일시트가 답합니다.
$color기본 글자색.
$color1 – $color12뉴트럴 램프. $color2 와 $color3 은 떠 있는 면, $color10 과 $color11 은 눌러 둔 글자, $color12 가 가장 큽니다.
$borderColor헤어라인. 반투명이라, 상관없는 회색이 아니라 어느 면 위에서도 가는 선으로 읽힙니다.
$accentBackground / $accentColor페이지에 허용된 단 하나의 큰 컨트롤. --primary 를 읽으므로 액센트 노브가 여기 닿습니다.
defaultsecondarydestructiveoutline

사다리

크기, 간격, 모서리는 어느 호스트에서나 같은 숫자이고, 모든 단에 노브가 있습니다.

타입. fontSize="$n" 이고 숫자는 아닙니다. 열두 단이 디자인 램프, --text-xs 부터 --text-9xl 까지를 읽고, 그 사이의 네 단은 이웃을 보간합니다. 사람의 스케일은 열여섯 단 모두를 움직이고, 사다리는 사다리로 남습니다.

단$1$2$3$4$5$6$7$8$9$10$11$14
px111314151517212626324064

$1 은 라벨, $2 는 내비게이션과 촘촘한 본문, $3 은 기준, $6 은 절 제목, $7 은 페이지 제목, $8 부터는 디스플레이입니다. 디스플레이 단은 행간과 자간을 −0.025em 까지 조입니다. 짜인 글자와 그저 큰 글자의 차이가 거기 있습니다.

간격. 4px 램프뿐이고, 다른 램프는 없습니다. $1 은 4, $2 는 8, $3 은 12, $4 는 16, $5 는 24, $6 은 32, $8 은 48, $10 은 64 입니다. 모든 단은 --density 가 곱합니다.

모서리. 값은 넷입니다. $1 과 $2 는 6, 컨트롤입니다. $3 과 $4 는 8, 입력이나 행입니다. $5 부터 $9 는 12, 패널입니다. $10 이상은 필입니다. 필을 뺀 나머지는 --radius-scale 이 곱합니다.

커스텀 프로퍼티

정체는 :root 의 커스텀 프로퍼티 한 벌이고, 다크가 먼저이며 .light 가 그것을 다시 맞춥니다. Hanzo 는 body 에 .t_dark 또는 .t_light 를 찍고, CSS 는 두 철자 모두에 답합니다. 컴포넌트 토큰과 스타일시트는 하나의 테마를 부릅니다.

:root {
  --background: #0a0a0a;
  --foreground: #e5e5e5;
  --primary: #fafafa;
  --border: rgb(255 255 255 / .10);
  --ring: rgb(255 255 255 / .40);
  --font-sans: 'Zen', ui-sans-serif, system-ui, sans-serif;
  --font-mono: 'Zen Mono', ui-monospace, monospace;
}

전체는 --background, --foreground, --card, --popover, --primary, --secondary, --muted, --accent, --destructive 이고, 각각에 -foreground 가 붙으며, 그다음 --border, --input, --ring, --radius, --chart-1 부터 --chart-5, 그리고 --sidebar-* 가족입니다. 이들은 @hanzo/design 에서 와 루트가 가져오는 스타일시트에 엮입니다. design 자신의 시트도 마운트하는 호스트는 그것을 실시간으로 따릅니다.

브랜드는 캐스케이드 뒤에서 같은 이름을 선언해 다시 맞춥니다. 자기 글꼴을 가져오는 호스트는 --font-sans 가 아니라 --font-sans-provided 를 묶습니다. 패키지의 묶음은 레이어 안에 있고, 레이어 없는 선언은 특이성에 상관없이 이기기 때문입니다.

모습의 노브

@hanzo/design 은 모든 램프가 곱하는 세 노브를 공개하고, @hanzo/appearance 는 사람을 위해 그것을 두는 패널입니다.

노브움직이는 것
--type-scale모든 --text-* 단과, 그에 따른 모든 fontSize="$n".
--type-ratio단과 단 사이의 거리.
--density모든 --space-* 단과, gui 의 gap 과 padding 전부.
--primary / --accent단 하나의 큰 색.
--font-sans읽는 글꼴. 브랜드의 것, 시스템의 것, 세리프, 모노.
--container-max / --container-prose / --container-wide페이지가 짜는 세 가지 행장.

이들은 html 의 인라인 프로퍼티로 내려앉습니다. 그곳이 :root 이므로, 더 센 셀렉터 없이도 모든 스타일시트를 이깁니다. 컴포넌트에 닿는 것은 gui 가 JavaScript 안에서 크기를 var(--text-base) 로 풀고, 그 var 가 요소 자리에서 여전히 캐스케이드를 읽기 때문입니다. 아무도 두지 않은 축은 중립이 아니라 부재입니다. 1 이라고 쓰면 같아 보이면서, 자기 스케일을 공개한 브랜드를 말없이 앞지릅니다.

import { Appearance } from '@hanzo/appearance'
import { bootScript } from '@hanzo/appearance/state'

// In <head>, so the first paint is already correct.
<script dangerouslySetInnerHTML={{ __html: bootScript() }} />

// Wherever the product keeps settings.
<Appearance />

Hanzo 는 마운트할 때마다 저장된 선호를 다시 적용합니다. 한 페이지에서 고른 것은 다음 페이지에서도 유지됩니다. 이 사이트 헤더의 컨트롤이 그 패널입니다.