Skip to content

UI输入

UiInput 是继承自 UiText

  • 输入框是特殊的可交互文本框,允许在用户聚焦时输入文本内容
  • 输入框存在提示文本,用于在无内容时提示输入信息,提示文本可以配置内容及字体颜色,其余属性将与文本内容一致(对齐方式、文本换行等)

属性

placeholder

默认值:'Type something here'

输入框的未输入时文本提示内容。

定义于 #L162


placeholderColor

默认值:{}

输入框显示的占位文本的颜色。

定义于 #L163


placeholderOpacity

默认值:1

输入框提示文本的不透明度。

定义于 #L164


isFocus

输入框是否聚焦。

定义于 #L165

静态方法

create()

创建并返回一个新的 Ui输入,初始parent为空。

返回值

类型说明
UiInput新建 UiInput 元素实例

定义于 #L168

方法

focus()

使输入框聚焦。

定义于 #L166


blur()

使输入框失去焦点。

返回值

类型说明
string输入框当前的输入值。

定义于 #L167

单元素焦点变化监听事件

focus

使输入框聚焦。


blur

使输入框失去焦点。

javascript
const inputDemo = UiInput.create(); // 静态方法,直接通过类上面的方法来使用。

//当监听到该输入框得到焦点时
inputDemo.events.add('focus',(uiInput) => {
    //xxx
})

//当监听到该输入框失去焦点时
inputDemo.events.add('blur', (uiInput) => {
    //xxx
})