关于 TextInput 组件

TextInput 是一个环绕本机“动作脚本”TextField 对象的单行组件。您可以使用样式自定义 TextInput 组件;当实例被禁用时,它的内容会显示为“disabledColor”样式表示的颜色。TextInput 组件也可以采用 HTML 格式,或作为掩饰文本的密码字段。

在应用程序中,TextInput 组件可以被启用或者禁用。在禁用状态下,它不接收鼠标或键盘输入。当启用时,它遵循与“动作脚本”TextField 对象相同的焦点、选择和导航规则。当一个 TextInput 实例有焦点时,您还可以使用以下按键来控制它:

按键

描述

箭头键

向左和向右移动一个字符的距离。

Shift + Tab

将焦点移到前一个对象。

Tab 键

将焦点移到下一个对象。

有关控制焦点的详细信息,请参阅创建自定义焦点导航FocusManager 类

每个 TextInput 实例的实时预览都会反映在创作过程中对属性检查器或“组件检查器”面板中的参数所做的更改。在实时预览中,文本是不可选定的,并且无法在舞台上的组件实例中输入文本。

在将 TextInput 组件添加到应用程序时,您可以使用“辅助功能”面板来使其可由屏幕读取器访问。