文本框

简介

文本框控件用于输入单行文本，并可设置禁用、只读、宽度、高度等可选属性。

使用方法

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

<wafctrl:text id="id" name="name" value="演示"/>

2.2 JS动态创建EAS8.0

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

2.3 通用DOM创建EAS8.0

<input id="id" type="text" class="ui-text  enter2tab form" ctrlrole="text">
<!--DOM创建好之后，使用js初始化控件-->
$("#id").wafText(options);

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

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

属性说明

id String 缺省值: null EAS7.5+

定义文本框的id

name String 缺省值: null EAS7.5+

定义文本框的名称

hidden Boolean 缺省值: false EAS7.5+

规定文本框为隐藏状态，默认值为false

disabled Boolean 缺省值: false EAS7.5+

规定文本框为禁用状态，默认值为false

readonly Boolean 缺省值: false EAS7.5+

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

maxlength Integer 缺省值: null EAS7.5+

规定文本框中字符的最大长度，中文以两个长度计算

minlength Integer 缺省值: null EAS8.2+

规定文本框中字符的最小长度，中文以两个长度计算

tabindex Integer 缺省值: 0 EAS7.5+

定义按下tab键时文本框控件获得焦点的顺序，默认值为0

value String 缺省值: null EAS7.5+

定义文本框的初始值，可以直接指定静态值或者通过EL表达式动态计算

placeholder string 缺省值: null EAS7.5+

文本框框提示文字

tagClass String 缺省值: null EAS7.5+

定义文本框样式类，可以添加一个或多个

style String 缺省值: null EAS7.5+

定义文本框的样式

height number 缺省值: null EAS7.5+

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

width number 缺省值: null EAS7.5+

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

方法说明

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事件。
返回值说明：无

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

禁用文本框控件.[参考样例]

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

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

启用文本框控件.[参考样例]

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

事件说明

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

文本框

简介