jQuery EasyUI 表單插件 - Numberbox 數字框
jQuery EasyUI 插件
擴展自 $.fn.validatebox.defaults。通過 $.fn.numberbox.defaults 重寫默認的 defaults。
數字框(numberbox)用於讓用戶僅能輸入數字的值。它可以把輸入元素轉換為不同類型的輸入(比如:數字 numeric、百分比 percentage、貨幣 currency,等等)。更多的輸入類型依賴 'formatter' 和 'parser' 函數來定義。
依賴
- validatebox
用法
從標記創建數字框(numberbox)。
<input type="text" class="easyui-numberbox" value="100" data-options="min:0,precision:2">
使用 javascript 創建數字框(numberbox)。
<input type="text" id="nn">
$('#nn').numberbox({
min:0,
precision:2
});
屬性
該屬性擴展自驗證框(validatebox),下麵是為數字框(numberbox)添加的屬性。
| 名稱 | 類型 | 描述 | 默認值 |
|---|---|---|---|
| disabled | boolean | 定義是否禁用該字段。 | false |
| value | number | 默認值。 | |
| min | number | 允許的最小值。 | null |
| max | number | 允許的最大值。 | null |
| precision | number | 顯示在小數點後面的最大精度。 | 0 |
| decimalSeparator | string | 分隔數字的整數部分和小數部分的分隔字元。 | . |
| groupSeparator | string | 分隔整數組合的字元。 | |
| prefix | string | 首碼字串。 | |
| suffix | string | 尾碼字串。 | |
| filter | function(e) | 定義如何過濾被按下的鍵,返回 true 則接受輸入字元。該屬性自版本 1.3.3 起可用。 | |
| formatter | function(value) | 用來格式數字框(numberbox)值的函數。返回顯示在框中的字串值。 | |
| parser | function(s) | 用來解析字串的函數。返回數字框(numberbox)值。 |
事件
| 名稱 | 參數 | 描述 |
|---|---|---|
| onChange | newValue,oldValue | 當字段值改變時觸發。 |
方法
該方法擴展自驗證框(validatebox),下麵是為數字框(numberbox)添加或重寫的方法。
| 名稱 | 參數 | 描述 |
|---|---|---|
| options | none | 返回選項(options)對象。 |
| destroy | none | 銷毀數字框(numberbox)對象。 |
| disable | none | 禁用該域。 |
| enable | none | 啟用該域。 |
| fix | none | 把值固定為有效的值。 |
| setValue | none | 設置數字框(numberbox)的值。 代碼實例:
$('#nn').numberbox('setValue', 206.12);
|
| getValue | none | 獲取數字框(numberbox)的值。 代碼實例:
var v = $('#nn').numberbox('getValue');
alert(v);
|
| clear | none | 清除數字框(numberbox)的值。 |
| reset | none | 重置數字框(numberbox)的值。該方法自版本 1.3.2 起可用。 |
jQuery EasyUI 插件
