Spinbutton
數值微調輸入
`spinbutton` 是 ARIA 對數值範圍控制項的正式名稱。使用者通常可以直接輸入數值，也可以逐步增加或減少。數字步進器只是它常見的一種外觀。
生活中的例子
實驗室人員把溫度設為 37.5°C。向上鍵增加 0.5，Page Up 增加 5，數值會停在驗證過的 45°C 上限。貼上無效文字時會顯示錯誤，不會偷偷改成別的值。
主要部分
- 01可編輯數值
- 02遞增遞減控制
- 03範圍與步距
什麼時候用
當使用者常要按固定步距調整數值，也需要直接輸入時，可以使用。這個數值必須有清楚的上下限。
什麼時候不要用
只有加減按鈕，不代表它就是 `spinbutton`。沒有上下限的數值、很長的選項清單，或一般輸入欄更清楚的任務，都不適合使用。
程式裡的名稱
input[type=number] or role=spinbutton with valuemin/valuemax/valuenow 上線前要檢查
每個欄位都要有程式能讀到的標籤。連結提示與錯誤，並保留已輸入內容。檢查自動填寫、鍵盤順序、驗證時機、送出狀態、失敗復原、縮放與多語系。
預期成果：使用 數值微調輸入 (Spinbutton) 解決這項需求，同時保留使用者目前的操作脈絡。 使用者情境：實驗室人員把溫度設為 37.5°C。向上鍵增加 0.5，Page Up 增加 5，數值會停在驗證過的 45°C 上限。貼上無效文字時會顯示錯誤，不會偷偷改成別的值。 建議介面模式：數值微調輸入 (Spinbutton)。 適用理由：當使用者常要按固定步距調整數值，也需要直接輸入時，可以使用。這個數值必須有清楚的上下限。 不應使用的情況：只有加減按鈕，不代表它就是 `spinbutton`。沒有上下限的數值、很長的選項清單，或一般輸入欄更清楚的任務，都不適合使用。 產品要求：定義預設、載入、沒有內容、錯誤、成功與復原狀態。保留使用者已輸入的內容，每個操作後都提供清楚回饋。 無障礙與韌性：使用結構正確的 HTML（語意化 HTML）和完整鍵盤操作。焦點要清楚可見，版面縮放後仍要好用。也要提供減少動態效果。遵守專案現有規則。除非專案已採用，否則不要新增介面元件庫。 驗收條件：主要任務可只用鍵盤完成，在 320px 寬度也能正常使用。焦點與狀態變化可被輔助工具讀出。載入、失敗、重試、取消與減少動態效果都已驗證。 證據與限制（證據邊界）：標準只涵蓋列出的範圍，不會替你決定外觀、產品做法或 Vibulary 的教學範例。 待確認：產品文字、資料來源、分析事件、支援裝置與語系，以及平台特有限制。
檢查這份需求
請 AI 程式助手檢查目前如何使用 數值微調輸入 (Spinbutton)。 定義：`spinbutton` 是 ARIA 對數值範圍控制項的正式名稱。使用者通常可以直接輸入數值，也可以逐步增加或減少。數字步進器只是它常見的一種外觀。 正式環境檢查：每個欄位都要有程式能讀到的標籤。連結提示與錯誤，並保留已輸入內容。檢查自動填寫、鍵盤順序、驗證時機、送出狀態、失敗復原、縮放與多語系。 修改程式前，先列出看到的證據、缺口、嚴重程度，以及最小且安全的修正。