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 插件