现在位置: 首页 > jQuery EasyUI 教程 > 正文

jQuery EasyUI 表单插件 - Numberbox 数字框


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