リスト:仕様
リストは、テキストや画像を縦方向に並べて表示するインデックスです。
バリアント
表現力豊かなリスト
柔軟なスタイリング、強調された選択状態、カスタマイズ可能なスロットを実現するには、表現力豊かなリストバリアントを使用します。

ベースラインリスト
ベースラインリストは引き続き利用できますが、最新のビジュアルスタイル、選択状態の表現、スロット機能は備えていません。
Webでは、表現力豊かなリストはベースラインリストを基盤として構築されています。

| バリアント | M3 | M3 Expressive |
|---|---|---|
| リスト(表現力豊かな) | -- | 利用可能 |
| リスト(ベースライン) | 利用可能 | 非推奨です。 代わりに表現力豊かなリストを使用してください。 |
構成
スタイル
標準スタイルとセグメントスタイルは外観上の選択肢であり、リストの動作には影響しません。

- 標準
- セグメント
リストの選択
リストで同時に使用できる選択モードは1つだけです。たとえば、単一アクションリストを複数選択リストに変更することはできますが、両方のモードを同時に適用することはできません。




リストのインタラクション
リストで利用できるインタラクションは次のとおりです:
リストのインタラクションのアクセシビリティについて詳しく見る

| カテゴリ | 構成 | M3 | M3 Expressive |
|---|---|---|---|
| スタイル | 標準 | 利用可能 | 利用可能 |
| セグメント | -- | 利用可能 | |
| 選択モード | 単一アクション、複数アクション、単一選択、複数選択 | 利用可能 | 利用可能 |
| インタラクション | 展開、スワイプ\* | 利用可能 | 利用可能 |
* スワイプでアクションを表示するインタラクションは、Android Viewsでのみ利用できます
トークンと仕様
表のメニューからトークンセットを選択してください。common セットは、ベースライントークンに新しい表現力豊かなのシェイプとサイズを組み合わせたものです。expand セットには、展開インタラクション用のトークンが含まれます。デザイントークンについて詳しく学ぶ
リスト - Common
リスト - Expand
構造

コンテナとラベルテキストは必須です。その他の要素はすべて任意です:
- コンテナ
- オーバーライン
- ラベルテキスト
- 末尾テキスト
- サポートテキスト
- 末尾アイコン
- ディバイダー
- 先頭アバター
- 先頭アイコン
- 先頭メディア(画像または動画)
柔軟性とスロット
M3 Design Kitには、柔軟な項目レイアウトを設計するためのカスタムスロット付きリストが含まれています。カスタムリストは、先頭・コンテンツ・末尾の3つのスロットを持つコンテナと捉えてください。各スロットには異なる要素を配置できます。
スロットのアクセシビリティ
スロットはデフォルトではアクセシビリティに対応していません。次の点を考慮してください:
- 要素は、リストのルール、構造、インタラクションパターンに従う必要があります
- 標準のリスト項目パディングを使用してください
- ターゲットサイズは48×48dp以上にしてください
- スクリーンリーダー利用者にとってリスト項目のナビゲーションが難しくならないよう、インタラクティブ要素を追加しないでください

- 先頭スロット
- コンテンツスロット
- 末尾スロット
WARNING
スロットを使用するには、カスタムコードを自ら実装し、保守・管理する必要があります
先頭と末尾のスロットは、コンテンツセクションより幅を小さくしてください。
1. 先頭スロットには次のものを配置できます:
- 視覚要素:アバター、アイコン、画像、動画のサムネイル
- 選択コントロール:チェックボックス、ラジオボタン、スイッチ
- カスタマイズ:バッジや大きめの画像
2. コンテンツスロットは最も幅の広いスロットにする必要があり、次のものを配置できます:
- デフォルトのコンテンツ:ラベルテキスト、サポートテキスト
- 任意の追加要素:バッジ、アイコン、インラインラベル、その他のテキスト要素
- 読みやすさを保つため、長いテキスト行は避けてください
3. 末尾スロットには次のものを配置できます:
- アクション要素やテキスト:アイコン、アイコンボタン、末尾テキスト
- 選択コントロール:チェックボックス、ラジオボタン、スイッチ

選択リスト
選択リストでは、リスト項目ごとに選択インタラクションを1つだけ使用してください。


カラー
色の値はデザイントークンを通じて実装されます。デザイナーはトークンに対応する色値を扱います。実装では、色の値は別の値を参照するトークンとして表現されます。デザイントークンについて詳しく学ぶ

ライトテーマとダークテーマで使用されるリストのカラーロール:
- サーフェス
- オンサーフェスバリアント
- オンサーフェス
- オンサーフェスバリアント
- オンサーフェスバリアント
- オンサーフェスバリアント
- アウトラインバリアント
- プライマリコンテナ
- オンプライマリコンテナ
- オンサーフェスバリアント
状態
状態は、コンポーネントやインタラクティブ要素のステータスを伝える視覚的な表現です。インタラクションステートについて詳しく見る
デフォルトのリスト項目

- 有効
- 無効
- ホバー
- フォーカス
- 押下
- ドラッグ
選択済みのリスト項目

- 有効
- 無効
- ホバー
- フォーカス
- 押下
- ドラッグ
寸法

シェイプモーフィング
リスト項目が選択されると、アクティブな項目を強調するため、角のシェイプが変化します:
- 未選択時のコーナー半径:内側4dp、外側16dp
- 選択時のコーナー半径:16dp(四隅すべて)


リスト(ベースライン)
ベースラインリストバリアントは利用可能で、既存の製品でも引き続き動作します。ただし、新しいデザインにはエクスプレッシブリストバリアントを推奨します。トークンと仕様
ベースラインリストのトークンは、common トークンセットに含まれています。
TIP
このセットには、表現力豊かな用のトークンもいくつか含まれています。
カラー
色の値はデザイントークンを通じて実装されます。デザイナーはトークンに対応する色値を扱います。実装では、色の値は別の値を参照するトークンとして表現されます。デザイントークンについて詳しく学ぶ

ライトテーマとダークテーマで使用されるリストのカラーロール:
- サーフェス
- オンサーフェス
- オンサーフェスバリアント
- オンサーフェスバリアント
- オンサーフェスバリアント
- アウトラインバリアント
- プライマリコンテナ
- オンプライマリコンテナ
- オンサーフェスバリアント
状態
状態は、コンポーネントやインタラクティブ要素のステータスを伝える視覚的な表現です。

- 有効
- 無効
- ホバー
- フォーカス
- 押下
- ドラッグ
レイアウト
1行リスト


2行リスト


3行リスト


| 属性 | 値 |
|---|---|
| ラベルの配置 | 中央揃え |
| 高さが88dp以上の場合のラベルの配置 | 上揃え |
| ラベルの左パディング | 16dp |
| 先頭要素の垂直配置 | 中央揃え |
| 高さが88dp以上の場合の先頭要素の垂直配置 | 上揃え |
| 先頭要素の左パディング | 16dp |
| 先頭アイコンの垂直配置 | 上揃え |
| 先頭アイコンの上パディング | 8dp |
| 高さが88dp以上の場合の先頭アイコンの上パディング | 12dp |
| 末尾要素の垂直配置 | 中央揃え |
| 高さが88dp以上の場合の末尾要素の垂直配置 | 上揃え |
| 末尾要素の左パディング | 16dp |
| 末尾要素の右パディング | 24dp |
| ディバイダーの上下パディング | 0dp |
| ターゲットサイズ | 48dp |
| ディバイダーの全幅 | 100% |
| ディバイダーのインセット左パディング | 16dp |
| ディバイダーのインセット右パディング | 24dp |
構成
先頭アバター

- 先頭アバターあり
- 先頭アバターと末尾チェックボックスあり
先頭画像またはサムネイル

- 先頭画像あり
- 先頭画像と末尾チェックボックスあり
先頭動画

- 先頭動画あり
- 先頭動画と末尾チェックボックスあり
先頭アイコン

- 先頭アイコンあり
- 先頭アイコンと末尾チェックボックスあり
テキストのみ

- テキストのみ
- テキストと末尾チェックボックスあり
先頭チェックボックス

- 先頭チェックボックスあり
- 先頭チェックボックスと末尾テキストあり
先頭ラジオボタン

- 先頭ラジオボタンあり
- 先頭ラジオボタンと末尾テキストあり
末尾スイッチ

- 末尾スイッチあり
- 先頭アイコンと末尾スイッチあり