ボタングループ: 仕様
ボタングループは、ボタンを整理し、ボタン間にインタラクションを追加します。
バリアント

- 標準ボタングループ
- 連結ボタングループ
| バリアント | M3 | M3 Expressive |
|---|---|---|
| 標準ボタングループ | -- | 利用可能 |
| 連結ボタングループ | セグメントボタンセグメントボタンは、ユーザーがオプションを選択したり、ビューを切り替えたり、要素を並べ替えたりするのに役立ちます。注: Expressive アップデートでは非推奨です。代わりにナビゲーションレールを使用してください。セグメントボタンの詳細として利用可能 | 利用可能 |
構成

両方のボタングループバリアントの構成:
- 極小(XS)
- 小(S)
- 中(M)
- 大(L)
- 特大(XL)
- 単一選択と複数選択
- 丸型と角型
| カテゴリ | 構成 | M3 | M3 Expressive |
|---|---|---|---|
| サイズ | XS、S、M、L、XL | -- | 利用可能 |
| デフォルトのシェイプ | 丸型、角型 | -- | 利用可能 |
| 選択 | 単一選択、複数選択、選択が必須 | セグメントボタンセグメントボタンは、ユーザーがオプションを選択したり、ビューを切り替えたり、要素を並べ替えたりするのに役立ちます。注: Expressive アップデートでは非推奨です。代わりにナビゲーションレールを使用してください。セグメントボタンの詳細として利用可能 | 利用可能 |
トークンと仕様
標準ボタングループと連結ボタングループのトークンは、サイズごとに整理されています。トークンセットメニューでバリアントとサイズを選択してください。ボタンとアイコンボタンのページに移動して、それぞれのトークンを表示してください。デザイントークンについて学ぶ
標準ボタングループ - サイズ - 極小(XS)
| Token | 値 |
|---|---|
| Button group xsmall container height | 32dp |
| Button group xsmall between space | 18dp |
標準ボタングループ - サイズ - 小(S)
| Token | 値 |
|---|---|
| Button group small container height | 40dp |
| Button group small between space | 12dp |
標準ボタングループ - サイズ - 中(M)
| Token | 値 |
|---|---|
| Button group medium container height | 56dp |
| Button group medium between space | 8dp |
標準ボタングループ - サイズ - 大(L)
| Token | 値 |
|---|---|
| Button group large container height | 96dp |
| Button group large between space | 8dp |
標準ボタングループ - サイズ - 特大(XL)
| Token | 値 |
|---|---|
| Button group xlarge container height | 136dp |
| Button group xlarge between space | 8dp |
連結ボタングループ - サイズ - 極小(XS)
| Token | 値 |
|---|---|
| Button group connected xsmall container height | 32dp |
| Button group connected xsmall space between buttons | 2dp |
| Button group connected xsmall container shape | Circular |
| Button group connected xsmall inner corner size | 8dp |
| Button group connected xsmall pressed inner corner size | 4dp |
| Button group connected xsmall selected inner corner size | 50% |
連結ボタングループ - サイズ - 小(S)
| Token | 値 |
|---|---|
| Button group connected small container height | 40dp |
| Button group connected small space between buttons | 2dp |
| Button group connected small container shape | Circular |
| Button group connected small inner corner size | 8dp |
| Button group connected small pressed inner corner size | 4dp |
| Button group connected small selected inner corner size | 50% |
連結ボタングループ - サイズ - 中(M)
| Token | 値 |
|---|---|
| Button group connected medium container height | 56dp |
| Button group connected medium space between buttons | 2dp |
| Button group connected medium container shape | Circular |
| Button group connected medium inner corner size | 8dp |
| Button group connected medium pressed inner corner size | 4dp |
| Button group connected medium selected inner corner size | 50% |
連結ボタングループ - サイズ - 大(L)
| Token | 値 |
|---|---|
| Button group connected large container height | 96dp |
| Button group connected large space between buttons | 2dp |
| Button group connected large container shape | Circular |
| Button group connected large inner corner size | 16dp |
| Button group connected large pressed inner corner size | 12dp |
| Button group connected large selected inner corner size | 50% |
連結ボタングループ - サイズ - 特大(XL)
| Token | 値 |
|---|---|
| Button group connected xlarge container height | 136dp |
| Button group connected xlarge space between buttons | 2dp |
| Button group connected xlarge container shape | Circular |
| Button group connected xlarge inner corner size | 20dp |
| Button group connected xlarge pressed inner corner size | 16dp |
| Button group connected xlarge selected inner corner size | 50% |
構造
ボタングループは目に見えないコンテナであり、ボタン間にパディングを追加し、ボタンのシェイプを変更します。デフォルトではボタンを含みません。

- コンテナ
一般的なレイアウト
用途に応じて、ボタンとアイコンボタンを組み合わせて使用します。

- ラベルボタン
- ラベルボタンとアイコンボタン
- 極小のアイコンボタン
- 大サイズのアイコンボタン
カラー
ボタングループ自体には色のプロパティはありません。デフォルトのボタンまたはトグルボタンのカラースタイル(塗りつぶし、トーナル、アウトラインなど)を使用できます。標準のアイコンボタンとテキストボタンはコンテナの装飾を持たないため、使用しないでください。

- 塗りつぶし
- トーナル
- アウトライン
- エレベーテッド
選択とアクティブ化
標準ボタングループでは、ボタンが選択またはアクティブ化されると、隣接するボタンとの間に連動した動きが発生します。
この連動により、選択またはアクティブ化されたボタンの幅、シェイプ、パディングが変化し、隣接するボタンの幅も調整されます。
連結ボタングループでは、ボタンが選択またはアクティブ化されても、ボタン間に連動した動きは生じません。
影響するのは、選択またはアクティブ化されたボタンのシェイプのみです。
状態
標準ボタングループ
標準ボタングループでは、ボタンが押下されると、そのボタンと隣接するボタンの幅とシェイプが変化します。

- 有効時
- 無効時
- ホバー時
- フォーカス時
- 押下時
標準ボタングループ内のトグルボタンが選択されると、そのシェイプは角型と丸型の間で切り替わります。色はボタン仕様に従って変化します。

- 有効時
- 無効時
- ホバー時
- フォーカス時
- 押下時
連結ボタングループ
連結ボタングループでは、標準ボタングループとはシェイプの変化の仕方が異なります。ボタンを選択しても、隣接するボタンには影響しません。

連結ボタングループの未選択状態:
- 有効時
- 無効時
- ホバー時
- フォーカス時
- 押下時

連結ボタングループの選択状態:
- 有効時
- ホバー時
- フォーカス時
- 押下時
寸法
標準ボタングループ
標準ボタングループでは、すべてのボタン間にパディングが適用されます。パディング量はボタンのサイズに応じて変化し、48dp の最小アクセシブルターゲットサイズを確保します。パディングの詳細については、ボタン仕様、アイコンボタン仕様を参照してください。

標準ボタングループの内部パディング:
- XS: 18dp
- S: 12dp
- M: 8dp
- L: 8dp
- XL: 8dp
連結ボタングループ
すべての連結ボタングループで、2dp のパディングを使用します。これにより、サイズが異なる場合でも視覚的な一貫性が保たれます。

丸型の連結ボタングループでは、内部パディングはすべてのサイズで 2dp です。外側のシェイプは完全な丸型で、内側のシェイプは角型のままです。コーナーサイズは次のとおりです:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp

角型の連結ボタングループでは、内部パディングはすべてのサイズで 2dp です。外側のシェイプのコーナーサイズは次のとおりです:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp
最小幅
極小(XS)および小(S)の連結ボタングループには、48dp × 48dp のターゲット領域があり、最小幅は 48dp です。

- 極小(XS)
- 小(S)
密度
ボタングループは、内部のボタンの密度に応じて調整されます。密度の詳細
