TextField是一个提供文本输入编辑的组件,可限制大小写的输入。
在screen文件中我们通过<a:textField>标签来定义一个TextField对象。
<a:textField bindTarget="login_dataset" id="user_name_tf" name="user_name"
prompt="HAP_USERNAME" width="150" typeCase="upper">
<a:events>
<a:event handler="login" name="enterdown"/>
</a:events>
</a:textField>
textField标签可以设置一个id属性,id是组件的唯一标识,我们可以在页面脚本中用$('id')的方法获得该id对应的组件对象,进而可以调用相应的函数方法。
textField标签的bindTarget属性可指定一个dataset对象的id,name属性可指定该dataset其中一个field的名字。这两个属性必须联合使用,其功能是将TextField对象绑定到dataset中的一个field上,进而我们只要对dataset进行操作就能即时反映在TextField上,另外TextField上的文字编辑也会立刻修改dataset中的数据。
events标签定义了需要响应的事件函数,例如enterdown事件,当键盘键入回车键时,TextField会触发enterdown事件,这样我们可以通过配置一个客户端函数login来响应。
function login(){
var lds = $('login_dataset');
var record = lds.getCurrentRecord();
Aurora.request({url:'login.svc', para:record.data, success:function(){
window.location.href='role_select.screen'
},scope:this});
}
表 1.
属性名
|
用途
|
默认值
|
是否必填
|
---|
bindTarget
|
组件所绑定的dataset数据集,属性值是dataset的ID。
|
|
|
className
|
组件的样式表。
|
|
|
emptyText
|
当组件没有值的时候显示在组件上的提示信息。
|
|
|
id
|
组件的唯一标识,可用$(id)方法获得组件对象。
|
|
|
marginWidth
|
组件与窗口之间的宽度差,单位像素(px),可以根据窗口宽度的改变而改变。
|
|
|
name
|
组件对应dataset数据集中的一个字段field,属性值是字段名。
|
|
|
prompt
|
输入框前的提示文字,默认调用BM的prompt。
|
|
|
readOnly
|
设定组件是否只读。
取值
true | false
| false
|
|
required
|
设定组件是否必填。
取值
true | false
| false
|
|
style
|
组件的样式。
|
|
|
typeCase
|
组件的大小写输入限制。
取值
upper | lower
|
|
|
width
|
组件的宽度,单位像素(px)。
| 150
|
|
表 2.
事件名
|
用途
|
---|
blur
|
失去焦点时触发的事件。
|
change
|
文本内容发生改变时触发的事件。
|
enterdown
|
敲击回车键时触发的事件。
|
focus
|
获得焦点时触发的事件。
|
keydown
|
键盘按下时触发的事件。
|
keypress
|
键盘敲击时触发的事件。
|
keyup
|
键盘抬起时触发的事件。
|
mouseover
|
鼠标移到组件上时触发的事件。
|
mouseout
|
鼠标移出组件时触发的事件。
|
Comments
0 Responses to the article暂时没有评论。