文字欄位:無障礙
文字欄位可讓使用者在 UI 中輸入文字。
使用案例
使用者應能:
- 使用輔助技術導覽至文字欄位並啟用該欄位
- 將資訊輸入文字欄位
- 接收並理解輔助文字與錯誤訊息
- 導覽至互動式圖示並加以選取
互動與樣式
無論是填滿文字欄位或外框文字欄位,其容器皆提供相同的功能。框線的色彩與粗細變化可提供清楚的互動視覺提示。


容器可在文字欄位與周圍內容之間建立對比,使文字欄位更容易被發現。
在某些情境中,若容器外框與背景的對比度至少為 3:1,可讓外框文字欄位更容易辨識。


鍵盤導覽
| 按鍵 | 動作 |
|---|---|
| Tab | 焦點會移至未停用的文字欄位 |
元素標籤
若 UI 文字已正確與元件建立關聯,輔助技術(例如螢幕閱讀器)會先朗讀 UI 文字,再朗讀元件的角色。
文字欄位的無障礙標籤應與該欄位顯示的標籤一致。

若文字欄位包含互動式後置圖示,該圖示的無障礙標籤應說明其功能。
例如,當密碼處於隱藏狀態時,檢視圖示的標籤為「顯示密碼」;當密碼可見時,標籤為「隱藏密碼」。
當圖示沒有可操作角色時(例如錯誤圖示),其標籤為「錯誤」。

文字欄位的前綴與後綴會提供符號與縮寫,協助使用者輸入正確的值。
前綴與後綴的無障礙標籤必須具有唯一的 id 屬性;例如,貨幣符號前綴應以貨幣名稱作為其標籤。

發生錯誤時,角色會套用「警示」,錯誤訊息則會套用至文字標籤。
若文字欄位同時顯示輔助文字與錯誤文字,無障礙標籤應先包含輔助文字,再包含錯誤文字。

字元計數器的無障礙標籤會說明文字欄位可輸入的字元數。

輔助文字顯示的內容也應作為該輔助文字的無障礙標籤。

若文字欄位為必填,請在文字欄位標籤結尾加上星號。無障礙標籤必須包含該星號。
