文本区

简介

文本区用于输入多行文本.

使用方法

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

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

2.2 JS动态创建EAS8.0+

var options={
	id:"textarea001",name:null,value:null,width:null,height:null,
	//定义密码框中字符的最大长度
	maxlength:null,minlength:null,disabled:false,readonly:false,hidden:false,
	style:null,tabindex:0,tagClass:null,
	//文本框提示文字
	placeholder:null,
	//当设置height属性值后，rows属性失效
	rows:null,
	//当设置width属性值后，cols属性失效
	cols:null
};
var dom =waf.createDOM("textarea",options);
waf.appendDOM(waf("body"),dom);
waf.initComponent("textarea",options,dom);

2.3 通用DOM创建EAS8.0+

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

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

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

属性说明

id String 缺省值: null EAS7.5+

定义文本区的id

name String 缺省值: null EAS7.5+

定义文本区的名称

value String 缺省值: null EAS7.5+

定义文本区的初始值

rows Integer 缺省值: null EAS7.5+

定义文本区的高度（以行数计），当设置height属性值后，rows属性失效

cols Integer 缺省值: null EAS7.5+

定义文本区的宽度（以平均字符数计），当设置width属性值后，cols属性失效

height String 缺省值: null EAS7.5+

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

width 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。在只读的文本区中，无法对内容进行修改，但用户可以通过tab键切换到该控件，选取或复制其中的内容。

hidden Boolean 缺省值: false EAS7.5+

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

style String 缺省值: null EAS7.5+

定义文本区的样式

tagClass String 缺省值: null EAS7.5+

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

tabindex Integer 缺省值: 0 EAS7.5+

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

placeholder string 缺省值: 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，则不触发onchange事件。默认会触发onchange事件。
返回值说明: 无

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

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

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

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

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

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

事件说明

onchange 参数: (event,ui) EAS7.5+

文本区中的值发生改变，在失去焦点或按下回车键后将触发onchange事件。[参考样例]

参数说明:
event-所响应的事件
ui-ui.previous为改变前的值，ui.current为改变后的值
返回值说明：如果返回false，则值不会被更新

onfocus 参数: (event) EAS7.5+

文本区获得焦点时将触发onfocus事件

onblur 参数: (event) EAS7.5+

文本区失去焦点将触发onblur事件

onselect 参数: (event) EAS7.5+

文本区中的文本被选择时，将触发onselect事件

onclick 参数: (event) EAS7.5+

文本区被单击时将触发onclick事件

ondbclick 参数: (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事件

onmouseout 参数: (event) EAS7.5+

当鼠标指针在文本区内按下鼠标键时，触发onmousedown事件

onmousemove 参数: (event) EAS7.5+

当鼠标指针在文本区内移动时，触发onmousemove事件

onmousedown 参数: (event) EAS7.5+