关于 TextArea 组件

TextArea 组件环绕着本机“动作脚本”TextField 对象。您可以使用样式自定义 TextArea 组件;当实例被禁用时,其内容以“disabledColor”样式所代表的颜色显示。TextArea 组件也可以采用 HTML 格式,或者作为掩饰文本的密码字段。

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

按键

描述

箭头键

将插入点向上、向下、向左或向右移动一行。

Page Down 键

向下移动一屏。

Page Up 键

向上移动一屏。

Shift + Tab

将焦点移到前一个对象。

Tab 键

将焦点移到下一个对象。

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

每个 TextArea 实例的实时预览都会反映创作时在属性检查器或“组件检查器”面板中对参数所做的更改。如果需要滚动条,它会出现在实时预览中,但并不起作用。在实时预览中,文本是不可选定的,并且无法在舞台上的组件实例中输入文本。

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

在需要多行文本字段的任何地方都可使用 TextArea 组件。如果需要单行文本字段,请使用TextInput 组件。例如,您可以在表单中使用 TextArea 组件作为注释字段。您可以设置侦听器来检查当用户切换到字段外时,字段是否为空。侦听器可能会显示错误信息,以指明必须在该字段中输入注释。

TextArea 组件参数

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

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

html 指明文本是 (true) 否 (false) 采用 HTML 格式。默认值为 false。 

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

wordWrap 指明文本是 (true) 否 (false) 自动换行。默认值为 true。

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

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

以下过程解释了如何在创作时将TextArea 组件添加到应用程序。在该范例中,组件为一个具有事件侦听器的“注释”字段,该侦听器确定用户是否输入了文本。

要创建具有 TextArea 组件的应用程序,请执行以下步骤:

  1. 将 TextArea 组件从“组件”面板拖到舞台上。
  2. 在属性检查器中,输入实例名称 comment
  3. 在属性检查器中,按照需要设置参数。但是,请将文本参数保留为空,将可编辑参数设为 true,将密码参数设为 false。
  4. 在时间轴中选择第一帧,打开“动作”面板,然后输入以下代码:
    textListener = new Object();
    textListener.handleEvent = function (evt){
      if (comment.length < 1)  {     
      Alert(_root, "错误", "您必须在此字段中至少输入一个注释", mxModal | mxOK); 
      }
    }
    comment.addEventListener("focusOut", textListener);
    

    该代码在 TextArea 实例 comment上设置了一个 FocusOut 事件处理函数,该事件处理函数用来验证用户是否在文本字段中键入了内容。

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