密码框

简介

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


使用方法

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


样例集合

  1. 密码框属性
  2. 密码框事件