数字输入框

简介

数字输入框专门用于输入数字类型的字段,提供多种数字显示形式，包括百分比，货币符，负数等，并且可设置精度，四舍五入的处理

使用方法

2.1 静态框架使用方法仅EAS7.5版本

<wafctrl:numberField id="id" name="name" />

2.2 JS动态创建EAS8.0+

var options = {id:"nums"}
var dom = waf.createDOM("numberField", options);
waf.appendDOM(waf("body"), dom);
waf.initComponent("numberField", options, dom);

2.3 通用DOM创建EAS8.0+

<input id="id" name="number" type="text" class="enter2tab ui-numberField form" ctrlrole="numberField" aria-disabled="false" style="" tabindex="0">

<!--DOM创建好之后，使用js初始化控件-->
$("#id").wafNumberField(options);

2.4 方法&事件使用EAS7.5+

//调用方法
waf("#id").wafNumberField('method', parameter...);
//eg:获取和设置值
waf("#id").wafNumberField("getValue");
waf("#id").wafNumberField("setValue");
//eg:更改事件
waf("#id").wafNumberField("option","onchange",fn);

属性说明

id String 缺省值: null EAS7.5+

定义数字输入框的id

name String 缺省值: null EAS7.5+

定义数字输入框的名称

allowGroup Boolean 缺省值: false)(能在运行期改变) EAS7.5+

设置是否开启千分位.

allowNegative Boolean 缺省值: true)(能在运行期改变) EAS7.5+

设置是否允许输入负数.

formatType String 缺省值: number) EAS7.5+

设置显示格式,包括:数字(‘number’)、货币(‘currency’)、百分比(‘percent’)、千分比(‘thousandth’).

currencySymbol String 缺省值: ￥)(能在运行期改变) EAS7.5+

设置货币符号.

dataType String 缺省值: bigdecimal)(能在运行期改变) EAS7.5+

设置数字的类型,bigdecimal代表浮点数,integer代表整数.

decimalPrecision Integer 缺省值: 2)(能在运行期改变) EAS7.5+

设置小数的精度.

disabled Boolean 缺省值: false) EAS7.5+

规定数字输入框为禁用状态，既不可用，也不可点击，默认值为false,一般通过disable或者enable方法来修改禁用状态。

hidden Boolean 缺省值: false)(能在运行期改变） EAS7.5+

定义数字输入框是否不可见，可直接通过jquery自带的show方法或者hide方法来处理隐藏。

max Double 缺省值: null)(能在运行期改变) EAS7.5+

设置数字输入框最大值.

min Double 缺省值: null)(能在运行期改变) EAS7.5+

设置数字输入框最小值.

readonly Boolean 缺省值: false)(能在运行期改变) EAS7.5+

规定数字输入框为只读状态，不能修改，但可以选中或者拷贝，默认值为false

roundType String 缺省值: round)(能在运行期改变) EAS7.5+

设置进位方式,包括:ceil(向上取整)、floor(向下取整)、round(四舍五入)

value Double 缺省值: null)(能在运行期改变) EAS7.5+

定义数字输入框的初始值，可以直接指定静态值或者绑定某个属性

tabindex Integer 缺省值: 0)(能在运行期改变) EAS7.5+

定义按下tab键时数字输入框控件获得焦点的顺序

style String 缺省值: null)(能在运行期改变) EAS7.5+

定义数字输入框的样式。一般不建议直接设置style，可以通过tagClass来扩展样式

tagClass String 缺省值: null)(能在运行期改变) EAS7.5+

定义数字输入框样式类，可以添加一个或多个

height Integer 缺省值: null)(能在运行期改变) EAS7.5+

定义数字输入框的高度.一般通过class来设置，不建议直接编写height或者设置style属性。

width Integer 缺省值: null)(能在运行期改变) EAS7.5+

定义数字输入框的宽度。一般不建议和style中的width和height重复定义，如果重复定义了，初始化时height和width优先级更高

placeholder String 缺省值: null EAS7.5+

数字输入框提示文字

operateState String 缺省值: EDIT EAS7.5+

数字输入框的显示状态控制，如果值为VIEW,则不显示编辑框。

方法说明

option 参数: (property[,value]) 返回值类型: (any) EAS7.5+

获得或设置数字输入框某属性的值，当value参数存在时，设置控件的property属性值，且无返回值，否则返回控件的property属性值.[参考样例]

参数说明:
- property：必要参数，数字输入框的属性
- value：可选参数，数字输入框的属性值
返回值说明：
- 数字框的值

disable 参数: (none) 返回值类型: (none) EAS7.5+

禁用数字控件.[参考样例]

参数说明：无
返回值说明：无

enable 参数: (none) 返回值类型: (none) EAS7.5+

启用数字控件.[参考样例]

参数说明：无
返回值说明：无

getValue 参数: (none) 返回值类型: (Number) EAS7.5+

取得控件的值.[参考样例]

参数说明：无
返回值说明：数字框对应的真实值

setValue 参数: (val,change) 返回值类型: (none) EAS7.5+

设置控件的值.[参考样例]

参数说明：
- val: 数字框中的真实值，必须为数字类型
- change: 默认为true，如果设置为false，则不触发onchange事件
返回值说明：无

事件说明

onchange 参数: (event,value)返回值:boolean EAS7.5+

当数字控件的值改变时,触发onchange事件.[参考样例]

参数说明：
- event：事件对象
- value: value是对象,包括两个属性:previous(改变前的值),current(改变后的值).
返回值说明：如果返回值为false，则改动不会生效

onfocus 参数: (event) EAS7.5+

数字输入框获得焦点时将触发onfocus事件

onblur 参数: (event) EAS7.5+

数字输入框失去焦点将触发onblur事件

onselect 参数: (event) EAS7.5+

数字输入框中的文本被选择时，将触发onselect事件

onclick 参数: (event) EAS7.5+

数字输入框被单击时将触发onclick事件

ondblclick 参数: (event) EAS7.5+

数字输入框被双击时将触发ondblclick事件

onkeyup 参数: (event) EAS7.5+

在数字输入框上释放按键时，将触发onkeyup事件

onkeydown 参数: (event) EAS7.5+

在数字输入框上按下键盘上的键时，将触发onkeydown事件

onkeypress 参数: (event) EAS7.5+

当浏览器捕获到数字输入框有键盘输入时触发onkeypress事件

onmouseover 参数: (event) EAS7.5+

当鼠标指针进入数字输入框内时，触发onmouseover事件

onmouseup 参数: (event) EAS7.5+

当鼠标指针在数字输入框内，并且鼠标按键被释放时，触发onmouseup事件

onmousedown 参数: (event) EAS7.5+

当鼠标指针在数字输入框内按下鼠标键时，触发onmousedown事件