カルーセル: 仕様
カルーセルは、スクロールによって画面内に表示したり画面外へ移動したりできるアイテムのコレクションを表示します。

- コンテナ
- ラージ カルーセルアイテム
- ミディアム カルーセルアイテム
- スモール カルーセルアイテム
トークンと仕様
コンポーネントの要素、属性、トークン、およびその値については、以下を参照してください。
カラー
カラー値はデザイントークンを使用して実装されます。デザインではトークンに対応するカラー値を扱い、実装ではカラー値を特定の値を参照するトークンとして表現します。デザイントークンについて詳しく見る

ライトスキームとダークスキームで使用されるカルーセルのカラーロール:
- コンテナ
- サーフェス
状態
状態とは、コンポーネントやインタラクティブな要素の現在の状態をユーザーに伝える視覚的な表現です。インタラクションステートについて詳しく見る

- 有効状態
- ホバー状態
- フォーカス状態
- 押下状態
- 無効状態
カルーセルアイテムの動的な幅
すべての種類のカルーセルアイテムは、コンテナの幅に応じて動的にサイズが調整されます。
ラージ アイテムの最大幅はカスタマイズ可能で、利用可能なスペースにカルーセルアイテムを最適に収めるために使用します。
スモール カルーセルアイテムの最小幅は40dp、最大幅は56dpです。
アイテムのサイズは、カルーセルレイアウト内の位置に応じて変化します。

スモール カルーセルアイテムには最小幅と最大幅があります。
マルチブラウズ
マルチブラウズ レイアウトでは、ラージ アイテム、ミディアム アイテム、スモール アイテムをそれぞれ少なくとも1つずつ同時に表示します。
- コンテナ
- ラージ カルーセルアイテム
- ミディアム カルーセルアイテム
- スモール カルーセルアイテム
寸法

マルチブラウズ カルーセルでは、コンテナの左右両側にパディングがあります。
| 属性 | 値 |
|---|---|
| 配置 | 垂直方向中央揃え |
| 開始側/終了側のパディング | 16dp |
| 上下のパディング | 8dp |
| アイテム間のパディング | 8dp |
| ラージ アイテムの幅 | 動的、またはユーザー設定可能 |
| ミディアム アイテムの幅 | 動的 |
| スモール アイテムの幅 | 40~56dp、動的 |
| アイテムのコーナー半径 | 28dp |
アンコンテインド
アンコンテインドレイアウトは、コンテナの端までスクロールするアイテムを表示します。
- コンテナ
- ラージ カルーセルアイテム
寸法

アンコンテインド カルーセルアイテムは、スクロール時に左右のパディング領域をはみ出して表示されます。
| 属性 | 値 |
|---|---|
| 配置 | 垂直方向中央揃え |
| 開始側のパディング | 16dp |
| 上下のパディング | 8dp |
| アイテム間のパディング | 8dp |
| アイテムのコーナー半径 | 28dp |
アンコンテインドのマルチアスペクト比
アンコンテインドのマルチアスペクト比レイアウトでは、幅の異なるカルーセルアイテムを表示します。

- コンテナ
- カルーセルアイテム(16:9)
- カルーセルアイテム(9:16)
- カルーセルアイテム(1:1)
- カルーセルアイテム(3:4)
寸法

アンコンテインドのマルチアスペクト比カルーセルには開始側のパディングのみがあり、アイテム間には8dpのパディングがあります。
| 属性 | 値 |
|---|---|
| 配置 | 垂直方向中央揃え |
| 開始側のパディング | 16dp |
| 上下のパディング | 8dp |
| アイテム間のパディング | 8dp |
| アイテムのコーナー半径 | 28dp |
ヒーロー
ヒーロー レイアウトでは、1つ以上のラージ アイテムと1つ以上のスモール アイテムを同時に表示します。
- コンテナ
- ラージ カルーセルアイテム
- スモール カルーセルアイテム
寸法

ヒーローカルーセルでは、コンテナの左右両側にパディングがあります。
| 属性 | 値 |
|---|---|
| 配置 | 垂直方向中央揃え |
| 開始側/終了側のパディング | 16dp |
| 上下のパディング | 8dp |
| アイテム間のパディング | 8dp |
| ラージ アイテムの幅 | 動的 |
| スモール アイテムの幅 | 40~56dp、動的 |
| アイテムのコーナー半径 | 28dp |
中央揃えヒーロー
中央揃えヒーロー レイアウトでは、1つ以上のラージ アイテムと2つのスモール アイテムを表示します。

- コンテナ
- ラージ カルーセルアイテム
- スモール カルーセルアイテム
寸法

中央揃えヒーローカルーセルでは、コンテナの左右両側にパディングがあります。
| 属性 | 値 |
|---|---|
| 配置 | 垂直方向中央揃え |
| 開始側/終了側のパディング | 16dp |
| 上下のパディング | 8dp |
| アイテム間のパディング | 8dp |
| ラージ アイテムの幅 | 動的 |
| スモール アイテムの幅 | 40~56dp、動的 |
| アイテムのコーナー半径 | 28dp |
全画面
全画面レイアウトでは、画面の端から端まで広がるラージ アイテムを1つ表示します。
- コンテナ
- ラージ カルーセルアイテム
寸法

全画面カルーセルは、ウィンドウ全体を端から端まで覆います。
| 属性 | 値 |
|---|---|
| 配置 | 中央揃え |
| 開始側/終了側のパディング | 0dp |
| 上下のパディング | 0dp |
| アイテム間のパディング | 16dp |