テキストフィールド: アクセシビリティ
テキストフィールドを使用すると、ユーザーは UI にテキストを入力できます。
ユースケース
ユーザーは以下の操作を行える必要があります:
- 支援技術を使用してテキストフィールドに移動し、アクティブにする
- テキストフィールドに情報を入力する
- サポートテキストとエラーメッセージを受け取り、理解する
- 操作可能なアイコンに移動して選択する
インタラクションとスタイル
塗りつぶしテキストフィールドとアウトラインテキストフィールドの両方のコンテナは、同じ機能を提供します。ストロークの色と太さが変化することで、操作状態を明確に示す視覚的な手がかりとなります。


コンテナは、テキストフィールドと周囲のコンテンツの間にコントラストを作り出すことで、テキストフィールドの発見しやすさを向上させます。
アウトラインテキストフィールドでは、コンテナのアウトラインと背景のコントラスト比を 3:1 以上にすると、フィールドの視認性が向上します。


キーボードナビゲーション
| キー | アクション |
|---|---|
| Tab | フォーカスが(無効化されていない)テキストフィールドに移動する |
要素のラベル付け
UI テキストが正しく関連付けられている場合、支援技術(スクリーンリーダーなど)は、UI テキストに続いてコンポーネントのロールを読み上げます。
テキストフィールドのアクセシビリティラベルは、テキストフィールドのラベルと同じです。

操作可能なトレーリング アイコンを備えたテキストフィールドでは、アクセシビリティラベルによってその機能を明確に示します。
たとえば、パスワードが非表示のときは表示アイコンのラベルを「パスワードを表示」に、パスワードが表示されているときは「パスワードを非表示にする」にします。
操作可能なロールを持たないアイコン(エラー アイコンなど)のラベルは「エラー」にします。

テキストフィールドのプレフィックスとサフィックスは、ユーザーが正しい値を入力できるようにするための記号や略語を示します。
プレフィックスとサフィックスのアクセシビリティラベルには一意の id 属性を設定する必要があります。たとえば、通貨記号のプレフィックスには通貨名を指定します。

エラーが発生した場合は、ロールを「alert」にし、アクセシビリティラベルにエラーメッセージを設定します。
サポートテキストとエラーメッセージの両方が表示される場合、アクセシビリティラベルには、サポートテキストを先に、エラーメッセージを後に含める必要があります。

文字カウンターのアクセシビリティラベルは、テキストフィールドに入力可能な文字数を示します。

サポートテキストの内容は、そのアクセシビリティラベルにも使用します。

テキストフィールドで入力が必須の場合は、テキストフィールドのラベルの末尾にアスタリスクを付けて示します。アクセシビリティラベルにもアスタリスクを含める必要があります。
