---
title: "サイズと密度"
description: "コントロールのサイズのための 5 段の高さ、押せるものを描く最小の大きさ、そしてコンテナが中のものに渡すサイズ。"
url: "https://tanrei.chnotchy.com/ja/foundations/size-and-density/"
last_updated: 2026-11-21T03:27:29.000Z
---

> このページは Tanrei のドキュメントの一部です。すべてのページは索引 [llms.txt](https://tanrei.chnotchy.com/llms.txt)（英語）に並んでいて、既定のシステムのコンポーネントの仕様は 1 つのファイル [llms-full.txt](https://tanrei.chnotchy.com/llms-full.txt) にまとまっています。

# サイズと密度

> コントロールのサイズのための 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 未満にした場合は、警告として知らされます。押されたことを受け取る範囲が最小ターゲットを下回る場合と、最小ターゲットがコントロールの高さを超える場合は、どのシステムでも拒否されます。

## レイヤでの設定

どちらも、レイヤが理由を添えて設定するトークンです。

```json
"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](https://tanrei.chnotchy.com/ja/foundations/theme-studio.md) では、「サイズ」の行にコントロールの高さ、サイズ単位、最小ターゲットがあります。

## コンテナに設定するサイズ

サイズは、コンポーネントが置かれる場所で設定します。Web では、ボタングループの `size` を設定すると、それが中の Button のうち自分のサイズを持たないすべてのサイズになります。

```html
<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 つです。

- [ボタングループ](https://tanrei.chnotchy.com/ja/components/button-group.md)は、中の Button に渡します。
- [ツールバー](https://tanrei.chnotchy.com/ja/components/toolbar.md)は、グループの中かどうかにかかわらず Button とメニュー付きボタンに渡し、オーバーフローボタンにも渡します。
- [リスト](https://tanrei.chnotchy.com/ja/components/list.md)は、中のリスト行に渡します。

次のコンポーネントは、自分のサイズを設定していなければ、これらのうちいちばん近いコンテナのサイズを受け取り、サイズを設定するコンテナがなければ medium で描かれます。[Button](https://tanrei.chnotchy.com/ja/components/button.md)、[メニュー付きボタン](https://tanrei.chnotchy.com/ja/components/button-with-menu.md)、[コピーボタン](https://tanrei.chnotchy.com/ja/components/copy-button.md)、[リスト行](https://tanrei.chnotchy.com/ja/components/list-row.md)、そして自分の行や部分をすべてそのサイズで描く[リスト](https://tanrei.chnotchy.com/ja/components/list.md)、[ツリービュー](https://tanrei.chnotchy.com/ja/components/tree-view.md)、[アコーディオン](https://tanrei.chnotchy.com/ja/components/accordion.md)、[目次](https://tanrei.chnotchy.com/ja/components/table-of-contents.md)、[説明リスト](https://tanrei.chnotchy.com/ja/components/description-list.md)、[テーブル](https://tanrei.chnotchy.com/ja/components/table.md)です。

サイズが届くのはそこまでです。アコーディオン、説明リスト、テーブルは、中に置かれたものにサイズを渡しません。テーブルのセルに置いた Button は、自分のサイズか、テーブルを囲むコンテナのサイズで描かれます。また、コンテナからサイズをまったく受け取らないコンポーネントもあります。

- [メニュー](https://tanrei.chnotchy.com/ja/components/menu.md)（コンテキストメニューや[メニューバー](https://tanrei.chnotchy.com/ja/components/menubar.md)のメニューを含みます）、[検索](https://tanrei.chnotchy.com/ja/components/search.md)のビュー、[セレクト](https://tanrei.chnotchy.com/ja/components/select.md)と[コンボボックス](https://tanrei.chnotchy.com/ja/components/combobox.md)のリスト。どれもページの上に、周りのコントロールとは別に開くので、ツールバーを small にしても、そこにある Button が開くメニューは小さくなりません。メニューと検索は、自分の `size` を設定しなければ medium です。セレクトとコンボボックスの選択肢は、ボックスのサイズに従います。
- ツールバーの中のセレクト、数値入力、テキスト入力、スライダー。どれも指定したサイズのままです。
- [タイムライン](https://tanrei.chnotchy.com/ja/components/timeline.md)。サイズはテキストの大きさを表します。
