@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 はマウントのたびに、保存された好みを掛け直します。あるページで選んだことは、次のページでも保たれます。このサイトのヘッダーのコントロールが、そのパネルです。