テキストフィールド:ガイドライン
テキストフィールドを使用すると、ユーザーは UI にテキストを入力できます。

使用方法
連絡先や支払い情報の入力など、ユーザーが UI にテキストを入力する必要がある場合は、テキストフィールドを使用します。

テキストフィールドには、次の 2 つのバリアントがあります。
- 塗りつぶしテキストフィールド
- アウトラインテキストフィールド
どちらのバリアントも、コンテナによって操作可能であることを示す視覚的な手がかりを提供し、機能は同じです。


アウトラインテキストフィールド
アウトラインテキストフィールドは、塗りつぶしテキストフィールドよりも視覚的な強調が低くなります。フォームのように多数のテキストフィールドがまとめて配置される場所では、強調を抑えることでレイアウトの簡素化に役立ちます。

テキストフィールドの選択
テキストフィールドの選択
どちらのバリアントも機能は同じです。使用するバリアントは、スタイルのみを基準に選ぶこともできます。
次の条件に最もよく合うバリアントを選択してください。
- アプリのビジュアルスタイルに最も合うもの
- UI の目的に最も適したもの
- ボタンなどの他のコンポーネントや周囲のコンテンツと最も明確に区別できるもの


同じ画面で両方のテキストフィールド バリアントを使用する
UI で両方のテキストフィールド バリアントを使用する場合は、セクションごとに一貫して使い分け、同じ領域内では混在させないでください。
たとえば、あるセクションではアウトラインテキストフィールドを使用し、別のセクションでは塗りつぶしテキストフィールドを使用します。


構造
塗りつぶしテキストフィールド

- コンテナ
- リーディング アイコン(任意)
- 未入力フィールドのラベルテキスト
- 入力済みフィールドのラベルテキスト
- トレーリング アイコン(任意)
- フォーカス時のアクティブインジケーター
- キャレット
- 入力テキスト
- サポートテキスト(任意)
- 有効状態のアクティブインジケーター
アウトラインテキストフィールド

- 有効状態のコンテナ アウトライン
- 未入力フィールドのラベルテキスト
- リーディング アイコン(任意)
- 入力済みフィールドのラベルテキスト
- トレーリング アイコン(任意)
- フォーカス時のコンテナ アウトライン
- キャレット
- 入力テキスト
- サポートテキスト(任意)
コンテナ
コンテナは、テキストフィールドと周囲のコンテンツの間にコントラストを作ることで、テキストフィールドを見つけやすくします。
塗りとストローク
テキストフィールドのコンテナには塗りがあり、ストロークはコンテナ全体の周囲または下端にのみ付きます。ストロークの色と太さは、テキストフィールドがアクティブであることを示すために変化させることができます。
角丸
アウトラインテキストフィールドのコンテナは角丸ですが、塗りつぶしテキストフィールドのコンテナは上部の角が丸く、下部の角は直角になっています。

ラベルテキスト
ラベルテキストは、どのような情報が求められているかをユーザーに伝えます。すべてのテキストフィールドにはラベルが必要です。
ラベルテキストは入力テキストと揃え、常に表示する必要があります。テキストフィールドの中央に配置するか、コンテナの上部付近に配置できます。
ラベルテキストは切り詰めたり、複数行にしたりしないでください。短く、明確で、完全に表示されるようにしてください。


隣接ラベル
フィールドの目的が別の隣接ラベルで示されている場合、テキストフィールド自体にラベルは必要ありません。
隣接ラベルは、テキストフィールドのコンテナのリーディングエッジに揃えてください。

必須テキスト インジケーター
フィールドが必須であることを示すには、ラベルテキストの横にアスタリスク(*)を表示し、そのアスタリスクが必須フィールドを示すことを次のいずれかの方法でユーザーに伝えます。
- サポートテキスト
- フォームの先頭に注記を 1 つ表示する
その他のベストプラクティスは次のとおりです。
- すべての必須フィールドに印を付けてください
- 必須項目のテキストに特定の色を使用している場合は、アスタリスクにも同じ色を使用してください

入力テキスト
入力テキストは、ユーザーがテキストフィールドに入力したテキストです。
テキストフィールドでは、入力テキストを次の方法で表示できます。
- 単一行のテキストフィールドは、テキストを 1 行のみ表示します
- 複数行のテキストフィールドは、複数行のテキストに合わせて拡張されます
- テキストエリアは、高さが固定されたフィールドです

プレフィックステキスト
テキストフィールドには、通貨記号などのプレフィックステキストを含めることができます。

サフィックステキスト
テキストフィールドには、測定単位やメール ドメインなどのサフィックステキストを含めることができます。


サポートテキストと文字カウンター
サポートテキストは、入力フィールドの使用方法など、入力フィールドに関する追加情報を伝えます。理想的には 1 行にしますが、必要に応じて複数行に折り返してもかまいません。常時表示するか、フォーカス時のみ表示するかを選択できます。
文字数または単語数の制限がある場合は、文字カウンターまたは単語カウンターを含めます。これらは、使用した文字数(または単語数)と上限値を表示します。

- サポートテキスト
- 文字カウンター
エラーテキスト
入力内容を検証するテキストフィールド(パスワードなど)では、サポートテキストをエラーテキストに置き換えます。これにより、行が追加されてコンテンツの位置がずれ、レイアウトが変わるのを防げます。
- エラーが 1 つだけ発生する可能性がある場合は、エラーテキストでエラーを回避する方法を説明します
- 複数のエラーが発生する可能性がある場合は、エラーテキストで最も発生しやすいエラーを回避する方法を説明します

エラー アイコン
テキストフィールドがエラー状態のときは、エラー アイコンを表示することを強くお勧めします。
これにより、視覚障害のあるユーザーにもエラーが強調され、エラーを伝える追加の知覚的な手がかりとなります。

アイコンと画像
テキストフィールド内のアイコンは任意です。テキストフィールドのアイコンには、次のような役割があります。
- マイク アイコンなど、使用可能な 入力方法を示す
- フィールドの内容をクリアするなど、追加機能への手がかりを提供する
- エラーを示す
リーディング アイコンとトレーリング アイコンは、書字方向(LTR/RTL)に応じて位置が変わります。
高さが 24dp の画像はテキストフィールド内に配置できます。この画像の高さにより、フィールド内で最適な上下のパディングを確保でき、アイコン サイズの推奨事項とも一致します。
- アイコン シグニファイア
アイコン シグニファイアは、テキストフィールドに必要な入力の種類を表し、ネストされたコンポーネントのタッチターゲットになることができます。たとえば、カレンダー アイコンをタップして日付ピッカーを表示できます。 - 有効またはエラーのアイコン
アイコンは有効な入力と無効な入力を示すことができ、色覚障害のあるユーザーにもエラー状態を明確に伝えます。 - クリア アイコン
クリア アイコンを使用すると、入力フィールド全体をクリアできます。入力テキストが存在する場合にのみ表示されます。 - 音声入力アイコン
マイク アイコンは、ユーザーが音声で文字を入力できることを示します。 - ドロップダウン アイコン
ドロップダウン矢印は、テキストフィールドにネストされた選択コンポーネントがあることを示します。 - 画像
画像は、クレジットカード番号など、必要な入力内容を視覚的に示すのに役立ちます。

- アイコン シグニファイア
- 有効またはエラーのアイコン
- クリア アイコン
- 音声入力アイコン
- ドロップダウン アイコン
- 画像
読み取り専用フィールド
読み取り専用のテキストフィールドには、ユーザーが編集できないあらかじめ入力されたテキストが表示されます。
読み取り専用のテキストフィールドは通常のテキストフィールドと同様のスタイルで表示されますが、読み取り専用であることが明示されます。


アダプティブデザイン
レイアウトがより大きな画面やさまざまな ブレークポイント に適応するときは、テキストフィールドに柔軟なコンテナの寸法を適用します。レイアウトの拡大に合わせて、マージン、パディング、コンテナ寸法の最小値と最大値を設定し、より読みやすい表示になるようタイポグラフィを調整します。

テキストフィールドが可変レイアウトで拡張される場合、固定のマージンやタイポグラフィ プロパティを維持しないでください。維持すると、テキストフィールドが必要以上に長くなる可能性があります。
たとえば、テキストフィールドは大きな画面の全幅に広がるべきではありません。

密度
高密度テキストフィールドを使用すると、ユーザーは大量の情報を素早く読み取り、操作できます。

デフォルトで密度を適用しない
デフォルトでテキストフィールドに密度を適用しないでください。適用すると、タッチターゲットが推奨の 48×48 CSS ピクセルを下回ります。代わりに、より高密度のレイアウトを選択したりテーマを変更したりするなど、ユーザーがより高い密度を選択できる方法を提供してください。
密度設定が有効な場合でも簡単に元に戻せるよう、設定を変更するためのすべてのタッチターゲットをそれぞれ最低 48×48 CSS ピクセルに保ってください。