您现在的位置是:首页 > 开发教程

开发教程

NumberBox(数值输入框)

2020-11-16 10:43:59 开发教程 admin
NumberBox(数值输入框)
扩展自$.fn.validatebox.defaults。使用$.fn.numberbox.defaults重写默认值对象。
数值输入框是用来限制用户只能输入数值型数据的。他可以转换一个输入的元素到其他类型

NumberBox(数值输入框)

扩展自$.fn.validatebox.defaults。使用$.fn.numberbox.defaults重写默认值对象。

数值输入框是用来限制用户只能输入数值型数据的。他可以转换一个输入的元素到其他类型,比如:数字、百分比、货币等。更多的输入类型定义依赖于'formatter'和'parser'函数。

依赖关系

  • validatebox

用法

使用标签创建数值输入框。

  1. <inputtype="text"class="easyui-numberbox"value="100"data-options="min:0,precision:2"></input>

使用Javascript创建数值输入框。

  1. <inputtype="text"id="nn"></input>
  1. $('#nn').numberbox({
  2. min:0,
  3. precision:2
  4. });

属性

数值输入框的属性扩展自validatebox(验证框),数值输入框新增的属性如下:

属性名 属性值类型 描述 默认值
disabled boolean 是否禁用该字段。 false
value number 默认值。
min number 允许的最小值。 null
max number 允许的最大值。 null
precision number 在十进制分隔符之后显示的最大精度。(即小数点后的显示精度) 0
decimalSeparator string 使用哪一种十进制字符分隔数字的整数和小数部分 .
groupSeparator string 使用哪一种字符分割整数组,以显示成千上万的数据。(比如:99,999,999.00中的','就是该分隔符设置。)
prefix string 前缀字符。(比如:金额的$或者¥)
suffix string 后缀字符。(比如:后置的欧元符号€)
filter function(e) 定义如何过滤按键,当返回true时则允许输入,反之禁止。(该属性自1.3.3版开始可用)
formatter function(value) 用于格式化数值的函数。返回字符串值以显示到输入框中。
parser function(s) 用于解析字符串的函数。返回数值。

事件

事件名 事件参数 描述
onChange newValue,oldValue 当字段值更改的时候触发。

方法

数值输入框的方法扩展自validatebox(验证框),数值输入框新增或重写的方法如下:

方法名 方法参数 描述
options none 返回数值输入框属性。
destroy none 销毁数值输入框对象。
disable none 禁用字段。
enable none 启用字段。
fix none 将输入框中的值修正为有效的值。
setValue value 设置数值输入框的值。

代码示例:

$('#nn').numberbox('setValue', 206.12);
getValue none 获取数值输入框的值。

代码示例:

var v = $('#nn').numberbox('getValue');
alert(v);
clear none 清楚数值输入框的值。
reset none 重置数值输入框的值。(该方法自1.3.2版开始可用)

>