Form Field
表單欄位
一個完整的輸入單元,包含可見標籤、控制項、選用提示、驗證狀態和相連的錯誤訊息。
生活中的例子
統一編號欄位會一直顯示標籤。輸入前先說明格式,驗證後再連到清楚的錯誤訊息。
主要部分
- 01持續顯示的標籤
- 02輸入控制項
- 03提示或格式
- 04驗證訊息
什麼時候用
每個需要輸入的值都要有完整欄位、無障礙名稱,以及固定的提示和錯誤位置。
什麼時候不要用
不要只用預留文字當標籤,也不要只靠顏色顯示錯誤。
程式裡的名稱
label + input + aria-describedby + error message 上線前要檢查
每個欄位都要有程式能讀到的標籤。連結提示與錯誤,並保留已輸入內容。檢查自動填寫、鍵盤順序、驗證時機、送出狀態、失敗復原、縮放與多語系。
預期成果:使用 表單欄位 (Form Field) 解決這項需求,同時保留使用者目前的操作脈絡。 使用者情境:統一編號欄位會一直顯示標籤。輸入前先說明格式,驗證後再連到清楚的錯誤訊息。 建議介面模式:表單欄位 (Form Field)。 適用理由:每個需要輸入的值都要有完整欄位、無障礙名稱,以及固定的提示和錯誤位置。 不應使用的情況:不要只用預留文字當標籤,也不要只靠顏色顯示錯誤。 產品要求:定義預設、載入、沒有內容、錯誤、成功與復原狀態。保留使用者已輸入的內容,每個操作後都提供清楚回饋。 無障礙與韌性:使用結構正確的 HTML(語意化 HTML)和完整鍵盤操作。焦點要清楚可見,版面縮放後仍要好用。也要提供減少動態效果。遵守專案現有規則。除非專案已採用,否則不要新增介面元件庫。 驗收條件:主要任務可只用鍵盤完成,在 320px 寬度也能正常使用。焦點與狀態變化可被輔助工具讀出。載入、失敗、重試、取消與減少動態效果都已驗證。 證據與限制(證據邊界):它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認:產品文字、資料來源、分析事件、支援裝置與語系,以及平台特有限制。
檢查這份需求
請 AI 程式助手檢查目前如何使用 表單欄位 (Form Field)。 定義:一個完整的輸入單元,包含可見標籤、控制項、選用提示、驗證狀態和相連的錯誤訊息。 正式環境檢查:每個欄位都要有程式能讀到的標籤。連結提示與錯誤,並保留已輸入內容。檢查自動填寫、鍵盤順序、驗證時機、送出狀態、失敗復原、縮放與多語系。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。