テキストフィールド:仕様
テキストフィールドは、ユーザーがUIにテキストを入力するためのコンポーネントです。
トークンと仕様
コンポーネントの要素、属性、トークン、およびその値は、以下の表で確認できます。デザイントークンについて学ぶ
テキストフィールド - 塗りつぶし
テキストフィールド - アウトライン
塗りつぶしテキストフィールド

- コンテナ
- 先頭アイコン(オプション)
- 未入力時のラベルテキスト
- 入力済み時のラベルテキスト
- 末尾アイコン(オプション)
- フォーカス時のアクティブインジケーター
- キャレット
- 入力テキスト
- サポートテキスト(オプション)
- 有効時のアクティブインジケーター
塗りつぶしテキストフィールドの色
カラー値はデザイントークンを使用して実装します。デザインではトークンに対応するカラー値を使用し、実装では、カラー値は値を参照するトークンになります。デザイントークンの詳細

ライトスキームとダークスキームで使用される塗りつぶしテキストフィールドのカラーロール:
- サーフェスコンテナハイエスト
- オンサーフェスバリアント
- オンサーフェスバリアント
- プライマリ
- オンサーフェスバリアント
- プライマリ
- プライマリ
- オンサーフェス
- オンサーフェスバリアント
- オンサーフェス
塗りつぶしテキストフィールドの状態
状態とは、コンポーネントやインタラクティブな要素のステータスを伝える視覚的表現です。インタラクションステートの詳細

- 有効時(未入力)
- フォーカス時(未入力)
- ホバー時(未入力)
- 無効時(未入力)
- 有効時(入力済み)
- フォーカス時(入力済み)
- ホバー時(入力済み)
- 無効時(入力済み)
塗りつぶしテキストフィールドのエラー状態
エラー状態とは、コンポーネントやインタラクティブな要素のステータスを伝える視覚的表現です。エラーメッセージには、問題の修正手順を表示できます。エラーメッセージは、エラーが解消されるまで、サポートテキストとしてテキストフィールドの下に表示されます。

- 有効時(未入力)
- フォーカス時(未入力)
- ホバー時(未入力)
- 有効時(入力済み)
- フォーカス時(入力済み)
- ホバー時(入力済み)
塗りつぶしテキストフィールドの測定値



| 属性 | 値 |
|---|---|
| コンテナのデフォルトの高さ | 56dp |
| ラベルの配置(未入力時) | 上下中央揃え |
| 上下パディング | 8dp |
| 左右パディング(アイコンなし) | 16dp |
| 左右パディング(アイコンあり) | 12dp |
| アイコンの配置 | 上下中央揃え |
| アイコンとテキスト間のパディング | 16dp |
| サポートテキストと文字数カウンターの上部パディング | 4dp |
| サポートテキストと文字数カウンター間のパディング | 16dp |
| ターゲットサイズ | 56dp |
塗りつぶしテキストフィールドの構成

未入力時および入力済み時の塗りつぶしテキストフィールド(次の要素を含む):
- サポートテキスト
- 末尾アイコン
- 先頭アイコン
- 先頭アイコンと末尾アイコン
- プレフィックス
- サフィックス
- 複数行テキストフィールド
アウトラインテキストフィールド

- 有効時のコンテナのアウトライン
- 先頭アイコン(オプション)
- 未入力時のラベルテキスト
- 入力済み時のラベルテキスト
- 末尾アイコン(オプション)
- フォーカス時のコンテナのアウトライン
- キャレット
- 入力テキスト
- サポートテキスト(オプション)
アウトラインテキストフィールドの色
カラー値はデザイントークンを使用して実装します。デザインではトークンに対応するカラー値を使用し、実装では、カラー値は値を参照するトークンになります。デザイントークンの詳細

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

- 有効時(未入力)
- フォーカス時(未入力)
- ホバー時(未入力)
- 無効時(未入力)
- 有効時(入力済み)
- フォーカス時(入力済み)
- ホバー時(入力済み)
- 無効時(入力済み)
アウトラインテキストフィールドのエラー状態
エラー状態とは、コンポーネントやインタラクティブな要素のステータスを伝える視覚的表現です。エラーメッセージには、問題の修正手順を表示できます。エラーメッセージは、エラーが解消されるまで、サポートテキストとしてテキストフィールドの下に表示されます。

- 有効時(未入力)
- フォーカス時(未入力)
- ホバー時(未入力)
- 有効時(入力済み)
- フォーカス時(入力済み)
- ホバー時(入力済み)
アウトラインテキストフィールドの測定値



| 属性 | 値 |
|---|---|
| コンテナの高さ | 56dp |
| 左右パディング(アイコンなし) | 16dp |
| 左右パディング(アイコンあり) | 12dp |
| アイコンとテキスト間のパディング | 16dp |
| アイコンの配置 | 上下中央揃え |
| サポートテキストと文字数カウンターの上部パディング | 4dp |
| サポートテキストと文字数カウンター間のパディング | 16dp |
| ラベルの配置 | 上下中央揃え |
| 入力済みラベルテキストの左右パディング | 4dp |
| ターゲットサイズ | 56dp |
アウトラインテキストフィールドの構成

未入力時および入力済み時のアウトラインテキストフィールド(次の要素を含む):
- サポートテキスト
- 末尾アイコン
- 先頭アイコン
- 先頭アイコンと末尾アイコン
- プレフィックス
- サフィックス
- 複数行テキストフィールド