検索: 仕様
検索では、キーワードまたはフレーズを入力すると、関連情報を取得できます。
バリアント
| バリアント | M3 | M3 Expressive |
|---|---|---|
| 検索 | 利用可能 | 利用可能 |
構成
スタイル
検索には次の2つのスタイルがあります:
- コンテインド:エクスプレッシブな外観と操作感を備えています。塗りつぶしのコンテナを使用し、検索バーを候補または結果のリストから分離します。
- ディバイデッド(ベースライン):最新のビジュアルスタイル、モーション、柔軟性を備えていません。


レイアウト
検索の候補と結果は、カスタマイズ可能なリストに表示されます。レイアウトには、全画面レイアウトとドッキングレイアウトの2つのオプションがあります。検索レイアウトの詳細




| カテゴリ | 構成 | M3 | M3 Expressive |
|---|---|---|---|
| スタイル | コンテインド | -- | 利用可能 |
| ディバイデッド | 利用可能 | 非推奨。コンテインドを使用してください。 | |
| レイアウト | ドッキング、全画面 | 利用可能 | 利用可能 |
トークンと仕様
表内のメニューからトークンセットを選択します。検索バー セットには、非フォーカス時の検索バーのトークンのみが含まれます。検索ビュー セットには、検索操作時に関係するその他すべてのトークン(すべてのスタイルとレイアウトを含む)が含まれます。デザイントークンの詳細
検索ビュー
| Token | 値 |
|---|---|
| Search view container surface tint layer color | #6750A4 |
検索バー
構造
検索は、検索バーと、候補および結果を表示するコンテナで構成されます。コンテナはデフォルトでは空です。コンテンツを追加するには、リストコンポーネントを使用します。ディバイデッド(ベースライン)スタイルでは、ディバイダーによって検索バーと結果が分離されます。

- 検索バーのコンテナ
- 先頭アイコン
- サポートテキスト
- 末尾アイコンとアバター(オプション)
- 入力テキスト
- 検索候補または結果を表示するコンテナ
例
- アバターがある場合
- 末尾にアイコンボタンが1つある場合
- 末尾にアイコンボタンが2つある場合
- 末尾にアイコンボタンとアバターがある場合

カラー
色の値はデザイントークンを通じて実装されます。デザイナーはトークンに対応する色の値を扱います。実装では、色の値としてトークンを使用します。
全画面レイアウト

ライトテーマとダークテーマにおける全画面検索のカラーロール:
- サーフェス Container Low
- On サーフェス Variant
- On サーフェス Variant
- サーフェス Container High
- On サーフェス Variant
- On サーフェス
ドッキングレイアウト

ライトテーマとダークテーマにおけるドッキング検索のカラーロール:
- サーフェス Container High
- On サーフェス Variant
- On サーフェス Variant
- サーフェス Container High
- On サーフェス Variant
- On サーフェス
状態
状態は、コンポーネントまたはインタラクティブ要素のステータスを伝える視覚的な表現です。フォーカス時の検索では、個々の要素がそれぞれのインタラクションステートを維持します。インタラクションステートの詳細
検索バー

- 有効
- ホバー
- フォーカス
- 押下(リップル)
検索候補と結果
検索は、候補および結果を表示するコンテナを備えています。コンテナはデフォルトでは空です。コンテンツを追加するには、リストコンポーネントを使用します。

- 有効
- ホバー
- フォーカス
- 押下(リップル)
寸法
検索バー


M3 Expressive では、検索バーはフォーカス時に拡大します。マージンは24dpから12dpに変化します。


| 要素 | 属性 | 値 |
|---|---|---|
| コンテナ | 幅 | 最小:360dp、最大:720dp |
| 高さ | 56dp | |
| ラベルの配置 | 開始端揃え | |
| 先頭パディング | 非フォーカス時:24dp、フォーカス時:12dp | |
| 末尾パディング | 非フォーカス時:24dp、フォーカス時:12dp | |
| 先頭アイコンとラベル間のパディング(タップターゲット基準) | 4dp | |
| ラベルと末尾アイコン間のパディング(タップターゲット基準) | 4dp | |
| アバター | サイズ | 30dp |
フォーカス時の検索
コンテインドスタイル


| 要素 | 属性 | 値 |
|---|---|---|
| 全画面コンテナ | 幅 | 画面の幅全体 |
| 高さ | 画面の高さ全体 | |
| ドッキングコンテナ | 幅 | 最小:360dp、最大:720dp |
| 高さ | 最小:240dp、最大:画面の高さの2/3 | |
| 検索バーのコンテナ | 高さ | 56dp |
| ラベルの配置 | 開始端揃え | |
| 先頭パディング | 16dp | |
| 末尾パディング | 16dp | |
| 先頭アイコンとラベル間のパディング(タップターゲット基準) | 4dp | |
| 先頭アイコンとラベル間のパディング(タップターゲット基準) | 4dp |
ディバイデッドスタイル

