Textbox

简介

Textbox是文本输入框控件,由label和键盘组成。当用户点击Textbox时,能够自动跳转到键盘输入界面,并能够修改文本内容。目前Textbox仅支持输入ASCII码字符。

Sample

Sample实现通过Textbox修改QRCode控件显示的二维码。

控件布局

layout

在Page中加入一个TextboxQRCode控件,其中Textboxbingchange属性设定为 onTextChange。

JS代码

onTextChange : function(event){
    var text =  event.detail.value; //获取Textbox的当前文本内容
    this.setData({QRCode : {version : 4, source : text ,refresh : true}});//设定QRCode中纠错等级和所需要转换的文本信息,并刷新
}

效果

为了显示效果,二维码的刷新操作进行了延迟处理。

画面中残有键盘印痕为GIF工具问题,实际运行中无这些影响。

sample

Textbox 属性

公共属性

  • 控件类型

    默认 Textbox,且不可改动。

  • 透明度

    设置背景颜色的透明度,范围: 0 ~ 255。也可以在背景颜色中设定。

    注:当背景图片的设定不为空时,将自动设置为 0。

名称

  • 控件名称

    设定控件的名称。

    在JS脚本中,可根据控件名称来指定控件,并对其进行设定或操作。

设计

  • 控件锁定

    选项:True/False

    设定该控件是否锁定。

    如果设定值为True,则设计器中无法移动该控件。

  • 是否隐藏控件

    选项:True/False

    设定该控件是否需要隐藏。

    如果设定值为True,设计器与实际效果都不会显示该控件及控件中的内容。

    当控件已隐藏时,可通过在工程管理器中点击来选中该控件。

调用属性

  • bindchange

    绑定change事件,如果设定值为onChange,当Textbox的键盘界面中,按下Enter键时,将触发该事件,调用onChange函数。

外观

  • 背景颜色

    设定背景颜色,设定背景颜色的ARGB值。

    可打开颜色选择器,通过颜色选择器修改RGB值。

    Alpha值(即透明度),可以直接修改设定值 或 修改透明度的值。背景颜色的透明度与属性透明度的值会自动保持一致。

  • 前景色

    设定控件中文本内容的颜色,设定值为ARGB值。

    可打开颜色选择器,通过颜色选择器修改设定RGB值。

    Alpha值(即透明度)需要通过手动修改设定。

    字体为点阵字体时(自带字体库均为点阵字体),alpha值设定无效。当字体为ttf字体时,alpha值有效。

  • 选择键盘

    设置Textbox弹出的键盘界面文件位置,默认keyboard/keyboard,将自动生成默认xml和JS文件。 用户可以根据需求自己制作键盘界面。

位置属性

  • x坐标点

    设定 控件的左上角 相对于 父控件的左上角 的横坐标。

  • y坐标点

    设定 控件的左上角 相对于 父控件的左上角 的纵坐标。

  • 高度

    设定控件的高度

  • 宽度

    设定控件的宽度

文本

  • 控件文本

    设定控件上显示的文本内容。当字体选项为asc 点阵字体时,无法显示非英文字符。

  • 文本对齐

    选项 : TopLeft/TopMiddle/TopRight/CenterLeft/CenterMiddle/CenterRight/BottomLeft/BottomMiddle/BottomRight

    设定文本内容在控件中的对齐方式。

  • 字体

    设定文本字体。

    自带点阵字体,字体大小为16,不可更改,否则会显示错误。

    如果想要设定其他字体,请先在字体库中添加对应的ttf文件。

  • 字体大小

    设定文本内容的字体大小。