테마
토큰은 테마에 대해 풀리고, 커스텀 프로퍼티가 정체를 나르며, 세 개의 노브로 사람이 그 전체를 다시 맞출 수 있습니다.
라이브러리 안에서 색 이름을 적은 곳은 없습니다. 컴포넌트는 $background 나 $color12 를 구하고, 테마가 답합니다. 답은 다크와 라이트에서 다르고, 컴포넌트는 그것을 모릅니다. 브랜드는 커스텀 프로퍼티를 두어 답을 바꾸고, 사람은 램프가 곱하는 노브를 움직여 바꿉니다.
토큰
$ 로 시작하는 prop 값은 토큰입니다. 색 램프는 바닥에서 글자로 갑니다. $color1 이 가장 조용한 바닥이고, $color12 가 가장 큰 글자입니다.
| 토큰 | 내용 |
|---|---|
$background | 페이지의 바닥. --background 를 읽으므로 브랜드의 스타일시트가 답합니다. |
$color | 기본 글자색. |
$color1 – $color12 | 뉴트럴 램프. $color2 와 $color3 은 떠 있는 면, $color10 과 $color11 은 눌러 둔 글자, $color12 가 가장 큽니다. |
$borderColor | 헤어라인. 반투명이라, 상관없는 회색이 아니라 어느 면 위에서도 가는 선으로 읽힙니다. |
$accentBackground / $accentColor | 페이지에 허용된 단 하나의 큰 컨트롤. --primary 를 읽으므로 액센트 노브가 여기 닿습니다. |
사다리
크기, 간격, 모서리는 어느 호스트에서나 같은 숫자이고, 모든 단에 노브가 있습니다.
타입. fontSize="$n" 이고 숫자는 아닙니다. 열두 단이 디자인 램프, --text-xs 부터 --text-9xl 까지를 읽고, 그 사이의 네 단은 이웃을 보간합니다. 사람의 스케일은 열여섯 단 모두를 움직이고, 사다리는 사다리로 남습니다.
| 단 | $1 | $2 | $3 | $4 | $5 | $6 | $7 | $8 | $9 | $10 | $11 | $14 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| px | 11 | 13 | 14 | 15 | 15 | 17 | 21 | 26 | 26 | 32 | 40 | 64 |
$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 는 마운트할 때마다 저장된 선호를 다시 적용합니다. 한 페이지에서 고른 것은 다음 페이지에서도 유지됩니다. 이 사이트 헤더의 컨트롤이 그 패널입니다.