目录

文本(Text)

功能说明

该控件用于文本录入。

HTML5

  1. <input id="tbLastName" value="abc" onchange="do()">

属性列表

属性名 属性值 说明
autofocus autofocus 在页面初始化加载的时候将自动获得焦点
placeholder 未获得焦点时的提示文本信息,即预置文本
value 文本框输入的值
maxlength 可录入文本的最大长度,最大值为256
keyboardoffset 输入控件弹出键盘Window的位移,解决键盘遮挡
bindfield 控件绑定字段
type textpassword 文本类型,值为text是正常文本,值为password是密文

支持公共属性
参见公共属性说明

事件列表

事件名 说明
oninput 输入类控件用户输入时触发的事件,焦点不需离开
onfocus 获得焦点时触发的事件
onchange 文本框内容改变且焦点离开后触发的事件
onblur 失去焦点时触发的事件
onsearch 搜索事件

实例

1、获取或修改文本框输入的值

  1. $id("xxx").get("value");
  2. $id("xxx").set("value", "美好的APP开发之旅")//文本内容更改为“美好的APP开发之旅”

2、onchange事件的使用

  1. <input id="textbox0" maxlength="256" placeholder="文本输入框" type="text" onchange="change()"/>
  1. function change(sender, args) {
  2. var v = $id("textbox0").get("value");
  3. $alert("文本框内容:" + v);
  4. }

3、oninput事件的使用

  1. <input id="textbox0" bindfield="a" maxlength="256" placeholder="文本输入框" type="text" oninput="this.oninput()"/>
  1. function com$requirements$Input_onchangeController$oninput(sender, args) {
  2. $ctx.dataCollect();
  3. var value = $id("textbox0").get("value"); //每输入一个字符就获取
  4. $id("textbox1").set("value", value); //textbox0每输入一个字符,焦点不需离开就在textbox1中显示
  5. }

4、让输入控件获得焦点

  1. function com$requirements$Input_focusController$button2_onclick(sender, args) {
  2. var data = $id("textbox0").get("value");
  3. if (data.length < 8) {
  4. $alert("您输入的密码不足8位,请重新输入");
  5. $id("textbox0").focus(); //textbox0的value长度不足8位时,让光标回到textbox0上
  6. } else {
  7. $alert("保存成功");
  8. }
  9. }

5、让输入控件获得焦点,并在焦点处插入字符

  1. function com$requirements$Input_focusController$button2_onclick(sender, args) {
  2. var data = $id("textbox0").get("value");
  3. if (data.length < 8) {
  4. $alert("您输入的密码不足8位,请重新输入");
  5. $id("textbox0").focus(); //textbox0的value长度不足8位时,让光标回到textbox0上
  6. $id("textbox0").insert("hello")//焦点的文本框最后,插入hello
  7. } else {
  8. $alert("保存成功");
  9. }
  10. }

6、让输入控件获得焦点,并在指定的位置处插入字符

  1. function com$requirements$Input_focusController$button2_onclick(sender, args) {
  2. var data = $id("textbox0").get("value"); //假设文本框输入字符为12345
  3. if (data.length < 8) {
  4. $alert("您输入的密码不足8位,请重新输入");
  5. $id("textbox0").focus(); //textbox0的value长度不足8位时,让光标回到textbox0上
  6. $id("textbox0").insert(1, "hello")// 12hello2345
  7. } else {
  8. $alert("保存成功");
  9. }
  10. }

7、如何解决输入类控件键盘遮挡

首先在application.xml文件中必须配置键盘弹出模式再为插件的属性设置位移量即可。

文档更新时间: 2018-01-12 16:31