密码框

简介

密码框控件用于输入密码，字符会以掩码（星号或圆点）显示，并可设置禁用、只读、宽度、高度等可选属性。

使用方法

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

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

2.2 JS动态创建EAS8.0

var options={
	id:"password001",name:null,value:null,width:null,height:null,
	//定义密码框中字符的最大长度
	maxlength:null,
	disabled:false,readonly:false,hidden:false,style:null,tabindex:0,tagClass:null	
};
var dom = waf.createDOM("password", options);
waf.appendDOM(waf("body"), dom);
waf.initComponent("password", options, dom);

2.3 通用DOM创建EAS8.0

<input id="id" type="password" class="ui-password enter2tab form" ctrlrole="password">

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

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

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

属性说明

id String 缺省值: null EAS7.5+

定义密码框的id;

name String 缺省值: null EAS7.5+

定义密码框的名称;

value String 缺省值: null EAS7.5+

定义密码框的初始值

width String 缺省值: null EAS7.5+

定义密码框的宽度，值可以是整数、百分比或字符串;

height String 缺省值: null EAS7.5+

定义密码框的高度，值可以是整数、百分比或字符串;

maxlength Integer 缺省值: null EAS7.5+

定义密码框中字符的最大长度;

minlength Integer 缺省值: null EAS8.2+

定义密码框中字符的最小长度;

disabled Boolean 缺省值: false EAS7.5+

规定密码框为禁用状态，默认值为false;

readonly Boolean 缺省值: false EAS7.5+

规定密码框为只读状态，不能修改，但可以选中或者拷贝，默认值为false;

hidden Boolean 缺省值: false EAS7.5+

规定密码框为隐藏状态，默认值为false;

style String 缺省值: null EAS7.5+

定义密码框的样式;

tagClass String 缺省值: null EAS7.5+

定义密码框样式类，可以添加一个或多个;

tabindex Integer 缺省值: 0 EAS7.5+

规定按下tab键时密码框控件获得焦点的顺序，默认值为0;

方法说明

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

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

参数说明:
property-必要参数，密码框的属性
value-可选参数，密码框的属性值
返回值说明: 无或者属性值

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

获得文本框中的值.

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

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

设置文本框中的值.

参数说明：
value:设置的值
change:如果设置为false，则不触发onchagne事件，默认会触发onchagne事件。
返回值说明：无

事件说明

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

本框中的值发生改变，在失去焦点后将触发onchange事件。
参数说明：

event-所响应的事件
val-val.previous为改变前的值，val.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事件

密码框

简介