原創元件 · Number Stepper
Number Stepper 數值步進器
以數值契約處理數值輸入、鍵盤與錯誤回復。這個展示的表單與 API 操作只在本頁模擬。
原生 JavaScript · 長按預設開啟 · 滾輪預設關閉
01 設定與模擬送出
數值須落在範圍與步距上。錯誤時保留手填內容;按 Escape 回到上一個有效值。
02 操作與 API
以下 API 操作對應「連線逾時」。非法 API 值只回報拒絕,不修改目前數值。
↑/↓:一個步距;PageUp/PageDown 或 Shift+方向鍵:十個步距。按鈕可用 Enter/空白鍵。長按開啟後,放開即停止。
API 與變更紀錄
只記錄有效值的實際變更,最多保留最近 40 筆。
- 尚無紀錄。
03 零值與狀態
0~20,步距 1。增加後重設,應回到 0。
初始 disabled,初始化後仍不可操作。
數值不可更改;手動輸入開啟時可聚焦讀取,關閉時不可聚焦。
04 五種尺寸
沿用 daisyUI 原生尺寸。切換手動輸入,比較輸入框與純數值顯示;五組寬度相同,方便比較高度、字級及按鈕比例。
0~100,步距 1;input-xs / btn-xs
0~100,步距 1;input-sm / btn-sm
0~100,步距 1;input-md / btn-md
0~100,步距 1;input-lg / btn-lg
0~100,步距 1;input-xl / btn-xl
05 小數與負數
預設仍從 0 起算;設定負的 min 才允許負數。試用加減、跨越 0、長按與手動輸入。超出範圍或不符合步距時保留輸入並提示。