← 返回元件目錄
原創元件 · Number Stepper

Number Stepper 數值步進器

以數值契約處理數值輸入、鍵盤與錯誤回復。這個展示的表單與 API 操作只在本頁模擬。

原生 JavaScript · 長按預設開啟 · 滾輪預設關閉

01 設定與模擬送出

數值須落在範圍與步距上。錯誤時保留手填內容;按 Escape 回到上一個有效值。

0~1000,步距 1;預設 30,0 代表不等待。

5~500,步距 5;試填 51,確認拒絕送出且保留內容。

尚未送出。請使用虛構設定試用。

02 操作與 API

以下 API 操作對應「連線逾時」。非法 API 值只回報拒絕,不修改目前數值。

↑/↓:一個步距;PageUp/PageDown 或 Shift+方向鍵:十個步距。按鈕可用 Enter/空白鍵。長按開啟後,放開即停止。

API 與變更紀錄

只記錄有效值的實際變更,最多保留最近 40 筆。

  1. 尚無紀錄。

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、長按與手動輸入。超出範圍或不符合步距時保留輸入並提示。

0~10;步距 0.5

0~2;步距 0.1

0~1;步距 0.01

-5~5;步距 1

-2~2;步距 0.5

0.05~0.34;步距 0.1

資料僅存於本頁;API 範例操作「十分位 0.1」。

數值契約與精度範圍