jQuery EasyUI 表单插件 - Numberbox 数字框


扩展自 $.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)添加的属性。

名称类型描述默认值
disabledboolean定义是否禁用该字段。false
valuenumber默认值。
minnumber允许的最小值。null
maxnumber允许的最大值。null
precisionnumber显示在小数点后面的最大精度。0
decimalSeparatorstring分隔数字的整数部分和小数部分的分隔字符。.
groupSeparatorstring分隔整数组合的字符。
prefixstring前缀字符串。
suffixstring后缀字符串。
filterfunction(e)定义如何过滤被按下的键,返回 true 则接受输入字符。该属性自版本 1.3.3 起可用。
formatterfunction(value)用来格式数字框(numberbox)值的函数。返回显示在框中的字符串值。
parserfunction(s)用来解析字符串的函数。返回数字框(numberbox)值。

事件

名称参数描述
onChangenewValue,oldValue当字段值改变时触发。

方法

该方法扩展自验证框(validatebox),下面是为数字框(numberbox)添加或重写的方法。

名称参数描述
optionsnone返回选项(options)对象。
destroynone销毁数字框(numberbox)对象。
disablenone禁用该域。
enablenone启用该域。
fixnone把值固定为有效的值。
setValuenone设置数字框(numberbox)的值。 代码实例:
$('#nn').numberbox('setValue', 206.12);
getValuenone获取数字框(numberbox)的值。 代码实例:
var v = $('#nn').numberbox('getValue');
alert(v);
clearnone清除数字框(numberbox)的值。
resetnone重置数字框(numberbox)的值。该方法自版本 1.3.2 起可用。