サイズと密度
コントロールのサイズのための 5 段の高さ、押せるものを描く最小の大きさ、そしてコンテナが中のものに渡すサイズ。
コントロールや行の高さは、3 つの値で決まります。コントロールの高さと最小ターゲットはデザインシステム全体のもので、プロダクトはそれぞれをレイヤで一度だけ設定します。サイズは 1 つのコンポーネント、またはそのグループのもので、ボタンは置かれた場所で small、medium、large のどれかになります。
段は tanrei.sys.control.height.* の 5 つの高さで、コントロールのサイズはここを読みます。medium はコントロールの高さ tanrei.dial.control.height(既定では 40)で、ほかの段はそこからサイズ単位(dial.size.unit、既定では 4px)の整数倍だけ下と上にあります。small は 2 つ、extra-small は 4 つ下、large は 4 つ、extra-large は 8 つ上です。いくつかのコントロールの高さでの値を、トークン自身のルールから計算して示します。
| トークン | dial.control.height 36px | dial.control.height 40px | dial.control.height 44px | dial.control.height 48px | dial.control.height 56px |
|---|---|---|---|---|---|
--tanrei-sys-control-height-extra-small | 20px | 24px | 28px | 32px | 40px |
--tanrei-sys-control-height-small | 28px | 32px | 36px | 40px | 48px |
--tanrei-sys-control-height-medium | 36px | 40px | 44px | 48px | 56px |
--tanrei-sys-control-height-large | 52px | 56px | 60px | 64px | 72px |
--tanrei-sys-control-height-extra-large | 68px | 72px | 76px | 80px | 88px |
生成元 design/tokens/tanrei.light.tokens.json, tokens/sys/measure.tokens.json
多くのコンポーネントが高さをこの段から読み、同じ段を読むもの同士は、どのコントロールの高さでも同じ高さのままです。Button の small、medium、large は、small、medium、large の段を読みます。段そのものには下限がありません。extra-small は、タグやキーボードショートカットのように、誰も押さないもののための段だからです。
tanrei.sys.target.minimum は、人が押すものを描く最小の高さで、アイコンだけのコントロールでは最小の幅でもあります。押せる箱や行の高さはどれもこれを下限として導出されるので、どのサイズでも、これより低くは描かれません。これは開発者が決める値で、どのダイヤルも拡大縮小しません。下限が、下限をかける相手と一緒に縮んでしまえば、下限の意味がないからです。
既定のシステムでは、最小は 36 で、ポインターでも指でも同じです。Button の高さを見ると、その働きがわかります。かっこ内の値はサイズとコントロールの高さが与える高さで、その前の高さが、最小ターゲットによってボタンが保たれている高さです。
| トークン | dial.control.height 36px | dial.control.height 40px | dial.control.height 44px | dial.control.height 48px | dial.control.height 56px |
|---|---|---|---|---|---|
--tanrei-comp-button-container-height-small | 36px (28px) | 36px (32px) | 36px | 40px | 48px |
--tanrei-comp-button-container-height-medium | 36px | 40px | 44px | 48px | 56px |
--tanrei-comp-button-container-height-large | 52px | 56px | 60px | 64px | 72px |
生成元 design/tokens/tanrei.light.tokens.json, tokens/comp/button.tokens.json
さらに 2 つの値が、押されたことをどれだけの範囲で受け取るかを決めます。指では sys.target.touch、細かいポインターでは sys.target.pointer です。どちらも既定では最小ターゲットと同じなので、1 つの値で 3 つすべてが決まります。プラットフォームのガイドラインに従うシステムは、これらを大きくします。そのとき、単独で置かれたコントロールは、描いた範囲を越えてその広い範囲から押されたことを受け取り、隣と接する行はその高さで描かれます。チェックボックスの箱や小さいチップのように、ターゲットより小さく描かれるしるしは、大きさを変えずに、ヒット領域をターゲットまで広げます。同梱の各システムの設定は次のとおりです。
| デザインシステム | minimum | touch | pointer |
|---|---|---|---|
tanrei | 36px | 36px | 36px |
cupertino | 28px | 44px | 28px |
m3-like | 32px | 48px | 44px |
生成元 tokens/systems/*.system.json, design/tokens/<system>/tanrei.light.tokens.json
ビルドはすべてのシステムを確かめます。3 つのどれも 24px(WCAG 2.5.8)を下回らないこと、touch と pointer が最小ターゲットを下回らないこと、最小ターゲットがコントロールの高さを超えないこと、そして下限のある高さが最小ターゲットを下回らないことです。プロダクト自身のレイヤがターゲットを 24px 未満にした場合は、警告として知らされます。押されたことを受け取る範囲が最小ターゲットを下回る場合と、最小ターゲットがコントロールの高さを超える場合は、どのシステムでも拒否されます。
どちらも、レイヤが理由を添えて設定するトークンです。
"tokens": {
"tanrei.dial.control.height": { "$value": { "value": 32, "unit": "px" }, "reason": "A tool used all day with a mouse: controls and rows lower." },
"tanrei.sys.target.minimum": { "$value": { "value": 32, "unit": "px" }, "reason": "Used with a mouse; 32 is the least we draw." }
}Web では高さがダイヤルの CSS 式になっているので、ルート要素に --tanrei-dial-control-height を設定すると、ビルドし直さなくても、それに従う高さがすべて一度に動きます。Theme Studio では、「サイズ」の行にコントロールの高さ、サイズ単位、最小ターゲットがあります。
サイズは、コンポーネントが置かれる場所で設定します。Web では、ボタングループの size を設定すると、それが中の Button のうち自分のサイズを持たないすべてのサイズになります。
<tanrei-button-group size="small">
<tanrei-button variant="outlined">Cancel</tanrei-button>
<tanrei-button variant="filled">Publish</tanrei-button>
<tanrei-button variant="text" size="medium">Details</tanrei-button>
</tanrei-button-group>- コンポーネント自身のサイズが優先されます。 上の 3 つめの Button は medium です。
- 渡されるのは、設定されたサイズだけです。
sizeのないグループは何も渡さないので、中の Button はそれぞれ自分の既定である medium か、グループを囲むコンテナが設定するサイズで描かれます。コンテナが入れ子になっているときは、サイズを設定しているいちばん近いコンテナで決まります。 - コンポーネントにないサイズは、いちばん近いサイズになります。 近さは extra-small、small、medium、large、extra-large の段の並びで測り、同じだけ近いものが 2 つあれば大きいほうになります。
- ボタングループとツールバーは、サイズによって自分では何も描き変えません。 間隔、角、区切り線はバリアントのとおりのままで、描かれる高さの項目を囲みます。
コンテナから渡されたサイズで描かれるコンポーネントも、自分のサイズで描かれるときと同じように、サイズの段と最小ターゲットに従います。コンテナのサイズを変えたり、コンポーネントをコンテナに入れたり出したりすると、その場で新しいサイズで描かれます。
設定されたサイズを中のものに渡すコンテナは 3 つです。
- ボタングループは、中の Button に渡します。
- ツールバーは、グループの中かどうかにかかわらず Button とメニュー付きボタンに渡し、オーバーフローボタンにも渡します。
- リストは、中のリスト行に渡します。
次のコンポーネントは、自分のサイズを設定していなければ、これらのうちいちばん近いコンテナのサイズを受け取り、サイズを設定するコンテナがなければ medium で描かれます。Button、メニュー付きボタン、コピーボタン、リスト行、そして自分の行や部分をすべてそのサイズで描くリスト、ツリービュー、アコーディオン、目次、説明リスト、テーブルです。
サイズが届くのはそこまでです。アコーディオン、説明リスト、テーブルは、中に置かれたものにサイズを渡しません。テーブルのセルに置いた Button は、自分のサイズか、テーブルを囲むコンテナのサイズで描かれます。また、コンテナからサイズをまったく受け取らないコンポーネントもあります。