NumberBox 繼承自 validatebox,並以 $.fn.numberbox.defaults 覆寫預設值。它在一般文字輸入框的基礎上,補上了「數值範圍限制」與「小數精度控制」兩項能力,讓使用者輸入非數字或超出範圍的值時能被自動攔下。
<input type="text" id="nn"></input>
$('#nn').numberbox({
min:0,
precision:2
});
上述設定代表:允許的最小值為 0,小數點後最多顯示兩位。
其特性擴展自 validatebox,以下為 NumberBox 新增者:
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| disabled | boolean | 定義是否停用該欄位。 | false |
| min | number | 允許的最小值。 | null |
| max | number | 允許的最大值。 | null |
| precision | number | 小數點後可顯示的最大位數。 | 0 |
值得留意的是 precision 預設為 0,也就是預設只接受整數。若欄位代表金額或需要小數,務必自行設定,否則輸入 12.5 會被判定為不合法。
| 名稱 | 參數 | 說明 |
|---|---|---|
| disable | none | 停用該欄位。 |
| enable | none | 啟用該欄位。 |
| fix | none | 把目前的值修正為合法數值,常用於失焦時將輸入內容正規化。 |
呼叫方式與其他 EasyUI 元件一致,例如 $('#nn').numberbox('disable');、$('#nn').numberbox('fix');。由於 NumberBox 本質上仍是 validatebox,因此 validate()、isValid() 等驗證方法也都能直接使用。