使用 TextInput 组件

在任何需要单行文本字段的地方,都可以使用 TextInput 组件。如果您需要多行文本字段,请使用TextArea 组件。例如,您可以在表单中将 TextInput 组件用作密码字段。您可以设置一个侦听器,检查用户按 Tab 键切换到字段之外时,该字段是否有足够的字符。该侦听器可以显示一条错误信息,指明必须输入正确的字符数。

TextInput 组件参数

以下是您可以在属性检查器中或在“组件检查器”面板中为每个 TextInput 组件设置的创作参数:

text 指定 TextInput 的内容。您无法在属性检查器或“组件检查器”面板中输入回车。默认值为 ""(空字符串)。

editable 指明 TextInput 组件是 (true) 否 (false) 可编辑。默认值为 true。

password 指明字段是 (true) 否 (false) 为密码字段。默认值为 false。 

您可以编写“动作脚本”,通过利用其属性、方法和事件来处理 TextInput 组件的这些和其他选项。有关详细信息,请参阅 TextInput 类

创建具有 TextInput 组件的应用程序

以下过程解释了如何在创作时将 TextInput 组件添加到应用程序。在本范例中,组件是带有事件侦听器的密码字段,事件侦听器确定输入的字符数是否正确。

要创建具有 TextInput 组件的应用程序,请执行以下操作:

  1. 将 TextInput 组件从“组件”面板拖到舞台上。
  2. 在属性检查器中,输入实例名称 passwordField
  3. 在属性检查器中,执行以下操作:
    • 将 text 参数保留为空。
    • 将 editable 参数设置为 true。
    • 将 password 参数设置为 true。
  4. 在时间轴中选择第一帧,打开“动作”面板,然后输入以下代码:
    textListener = new Object();
    textListener.handleEvent = function (evt){
      if (evt.type == "enter"){
        trace("You must enter at least 8 characters");
      }
    }
    passwordField.addEventListener("enter", textListener);
    

    该代码在 TextInput passwordField 实例上设置了一个 enter 事件处理函数,该事件处理函数用来验证用户输入的字符数是否正确。

  5. passwordField 实例中输入文本后,您可以获取它的值,如下所示:
    var login = passwordField.text;