数字输入框

简介

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


使用方法

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

onmouseout 参数: (event) EAS7.5+

当鼠标指针离开数字输入框时,触发onmouseout事件

onmousemove 参数: (event) EAS7.5+

当鼠标指针在数字输入框内移动时,触发onmousemove事件。


样例集合

  1. 数字输入框属性样例
  2. 数字输入框方法样例
  3. 数字输入框事件样例
  4. 动态化样例