ボタン: 仕様
ボタンは、UI のほとんどのアクションを開始する要素です。
バリアント

- デフォルトボタン
- トグルボタン
| バリアント | M3 | M3 Expressive |
|---|---|---|
| デフォルト | 利用可能 | 利用可能 |
| トグル(選択) | -- | 利用可能 |
構成

- サイズ
- シェイプ
- カラー
- 小サイズボタンのパディング
| カテゴリ | 構成 | M3 | M3 Expressive |
|---|---|---|---|
| サイズ | 小(デフォルト) | 利用可能 | 利用可能 |
| XS, M, L, XL | -- | 利用可能 | |
| シェイプ | ラウンド(デフォルト) | 利用可能 | 利用可能 |
| スクエア | -- | 利用可能 | |
| カラー | エレベーテッド、塗りつぶし(デフォルト)、トーナル、アウトライン、テキスト | 利用可能 | 利用可能 |
| 小サイズボタンのパディング | 24dp | 利用可能 | 非推奨(16dp を使用) |
| 16dp | -- | 利用可能 |
トークンと仕様
表のメニューからトークンセットを選択します。ボタンのトークンセットは、共通トークン、カラー、サイズに分かれています。ベースライントークンを表示
ボタン - カラー - エレベーテッド
ボタン - カラー - 塗りつぶし
ボタン - カラー - トーナル
ボタン - カラー - アウトライン
ボタン - カラー - テキスト
ボタン - サイズ - 極小
| Token | 値 |
|---|---|
| Button xsmall container height | 32dp |
| Button xsmall outline width | 1dp |
| Button xsmall label font | Roboto |
| Button xsmall label line height | 20pt |
| Button xsmall label size | 14pt |
| Button xsmall label weight | 500 |
| Button xsmall label tracking | 0.1pt |
| Button xsmall icon size | 20dp |
| Button xsmall shape round | Circular |
| Button xsmall shape square | 12dp |
| Button xsmall leading space | 12dp |
| Button xsmall between icon label space | 4dp |
| Button xsmall trailing space | 12dp |
| Button xsmall shape pressed morph | 8dp |
| Button xsmall shape spring animation damping | 0.9 |
| Button xsmall shape spring animation stiffness | 1400 |
| Button xsmall selected container shape round | 12dp |
| Button xsmall selected container shape square | Circular |
ボタン - サイズ - 小
| Token | 値 |
|---|---|
| Button small container height | 40dp |
| Button small outline width | 1dp |
| Button small label font | Roboto |
| Button small label line height | 20pt |
| Button small label size | 14pt |
| Button small label weight | 500 |
| Button small label tracking | 0.1pt |
| Button small icon size | 20dp |
| Button small shape round | Circular |
| Button small shape square | 12dp |
| Button small leading space | 16dp |
| Button small between icon label space | 8dp |
| Button small trailing space | 16dp |
| Button small shape pressed morph | 8dp |
| Button small shape spring animation damping | 0.9 |
| Button small shape spring animation stiffness | 1400 |
| Button small selected container shape round | 12dp |
| Button small selected container shape square | Circular |
ボタン - サイズ - 中
| Token | 値 |
|---|---|
| Button medium container height | 56dp |
| Button medium outline width | 1dp |
| Button medium label font | Roboto |
| Button medium label line height | 24pt |
| Button medium label size | 16pt |
| Button medium label weight | 500 |
| Button medium label tracking | 0.15pt |
| Button medium icon size | 24dp |
| Button medium shape round | Circular |
| Button medium shape square | 16dp |
| Button medium leading space | 24dp |
| Button medium between icon label space | 8dp |
| Button medium trailing space | 24dp |
| Button medium shape pressed morph | 12dp |
| Button medium shape spring animation damping | 0.9 |
| Button medium shape spring animation stiffness | 1400 |
| Button medium selected container shape round | 16dp |
| Button medium selected container shape square | Circular |
ボタン - サイズ - 大
| Token | 値 |
|---|---|
| Button large container height | 96dp |
| Button large outline width | 2dp |
| Button large label font | Roboto |
| Button large label line height | 32pt |
| Button large label size | 24pt |
| Button large label weight | 400 |
| Button large label tracking | 0 |
| Button large icon size | 32dp |
| Button large shape round | Circular |
| Button large shape square | 28dp |
| Button large leading space | 48dp |
| Button large between icon label space | 12dp |
| Button large trailing space | 48dp |
| Button large shape pressed morph | 16dp |
| Button large shape spring animation damping | 0.9 |
| Button large shape spring animation stiffness | 1400 |
| Button large selected container shape round | 28dp |
| Button large selected container shape square | Circular |
ボタン - サイズ - 特大
| Token | 値 |
|---|---|
| Button xlarge container height | 136dp |
| Button xlarge outline width | 3dp |
| Button xlarge label font | Roboto |
| Button xlarge label line height | 40pt |
| Button xlarge label size | 32pt |
| Button xlarge label weight | 400 |
| Button xlarge label tracking | 0 |
| Button xlarge icon size | 40dp |
| Button xlarge shape round | Circular |
| Button xlarge shape square | 28dp |
| Button xlarge leading space | 64dp |
| Button xlarge between icon label space | 16dp |
| Button xlarge trailing space | 64dp |
| Button xlarge shape pressed morph | 16dp |
| Button xlarge shape spring animation damping | 0.9 |
| Button xlarge shape spring animation stiffness | 1400 |
| Button xlarge selected container shape round | 28dp |
| Button xlarge selected container shape square | Circular |
構造

- コンテナ
- ラベルテキスト
- アイコン(省略可能)
カラー
カラー値はデザイントークンデザイントークンは、すべての UI 要素の構成要素です。同じトークンがデザイン、ツール、コードで使用されます。トークンの詳細を介して実装されます。デザイナーはトークンに対応するカラー値を扱い、実装ではカラー値は特定の値を参照するトークンとして扱われます。
- ボタンには、エレベーテッド、塗りつぶし、トーナル、アウトライン、テキストという 5 つの組み込みカラースタイルがあります
- デフォルトボタンとトグルボタンでは、使用するカラーが異なります
- トグルボタンはテキストスタイルを使用しません
TIP
これらのカラーロールは、デザインの一貫性と親しみやすさを生み出すために選ばれています。コンテナとテキストのコントラスト比が 3:1 を満たす限り、他のカラーロール(例: ターシャリとオンターシャリ)も使用できます。

A. エレベーテッド、B. 塗りつぶし、C. トーナル、D. アウトライン、E. テキスト
- デフォルト
- トグル: 未選択
- トグル: 選択済み
| 1. デフォルト | 2. トグル: 未選択 | 3. トグル: 選択済み | |
|---|---|---|---|
| エレベーテッドコンテナ エレベーテッドのアイコンとラベル | サーフェスコンテナロー プライマリ | サーフェスコンテナロー プライマリ | プライマリ オンプライマリ |
| 塗りつぶしコンテナ 塗りつぶしのアイコンとラベル | プライマリ オンプライマリ | サーフェスコンテナ オンサーフェスバリアント | プライマリ オンプライマリ |
| トーナルコンテナ トーナルのアイコンとラベル | セカンダリコンテナ オンセカンダリコンテナ | セカンダリコンテナ オンセカンダリコンテナ | セカンダリ オンセカンダリ |
| アウトラインコンテナ アウトラインのアイコンとラベル | アウトラインバリアント(アウトライン) オンサーフェスバリアント | アウトラインバリアント(アウトライン) オンサーフェスバリアント | インバースサーフェス インバースオンサーフェス |
| テキストのアイコンとラベル | プライマリ | -- | -- |
状態
状態状態は、コンポーネントや UI 要素のインタラクション状態を示します。状態の詳細とは、コンポーネントやインタラクティブ要素の現在のステータスを視覚的に伝えるものです。エレベーテッドボタンの状態
エレベーテッドボタンのエレベーションは、デフォルトで 1、無効時は 0 です。
デフォルト

- 有効
- 無効
- ホバー
- フォーカス
- 押下
トグル

A. 未選択、B. 選択済み
- 有効
- 無効
- ホバー
- フォーカス
- 押下
塗りつぶしボタンの状態
デフォルト

- 有効
- 無効
- ホバー
- フォーカス
- 押下
トグル

A. 未選択、B. 選択済み
- 有効
- 無効
- ホバー
- フォーカス
- 押下
トーナルボタンの状態
デフォルト

- 有効
- 無効
- ホバー
- フォーカス
- 押下
トグル

A. 未選択、B. 選択済み
- 有効
- 無効
- ホバー
- フォーカス
- 押下
アウトラインボタンの状態
通常時、アウトラインボタンのコンテナには塗りつぶしが表示されません。ただし、無効時、ホバー時、フォーカス時、押下時の不透明度とステートレイヤーは、他のボタンスタイルと同じように動作します。
デフォルト

- 有効
- 無効
- ホバー
- フォーカス
- 押下
トグル

- 有効
- 無効
- ホバー
- フォーカス
- 押下
テキストボタンスタイルの状態
通常時、テキストボタンのコンテナは表示されません。ただし、無効時、ホバー時、フォーカス時、押下時の不透明度とステートレイヤーは、他のボタンスタイルと同じように動作します。テキストボタンにトグルはありません。

- 有効
- 無効
- ホバー
- フォーカス
- 押下
シェイプモーフ
押下状態
押下時には、ボタンをよりスクエアなシェイプに変形できます。ラウンドボタンとスクエアボタンでは、押下時のシェイプを同じにする必要があります。
コーナー半径の値はボタンのサイズごとに異なります。ボタンのコーナーサイズ一覧を見る

A. ラウンドボタン、B. スクエアボタン
- 有効
- ホバー
- 押下
選択時
押下時にシェイプが変わるだけでなく、トグルボタンは通常時のシェイプもラウンド(未選択)からスクエア(選択済み)へと変化します。
未選択時の通常シェイプがスクエアの場合、選択時のシェイプはラウンドにする必要があります。

A. ラウンドボタン、B. スクエアボタン
- 有効
- ホバー
- 押下
- 選択済み
寸法

各ボタンサイズのパディングと寸法
- 極小
- 小
- 中
- 大
- 特大
ターゲット領域
極小(XS)および小(S)サイズのアイコンボタンでは、アクセシビリティ確保のため、48×48dp 以上のターゲット領域が必要です。

A. 極小 B. 小
- ラウンドボタン
- アイコン付きボタン
- スクエアボタン
コーナーサイズ

| XS | S | M | L | XL | |
|---|---|---|---|---|---|
| A. ラウンドボタン | フルラウンド | フルラウンド | フルラウンド | フルラウンド | フルラウンド |
| B. スクエアボタン | 12dp | 12dp | 16dp | 28dp | 28dp |
| C. 押下状態 | 8dp | 8dp | 12dp | 16dp | 16dp |
ベースライントークン
表のメニューからトークンセットを切り替えます。ベースラインのボタントークンセットはカラー別に整理されています。