关于 TextArea 组件

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

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

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

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

按键	描述
箭头键	将插入点向上、向下、向左或向右移动一行。
Page Down 键	向下移动一屏。
Page Up 键	向上移动一屏。
Shift + Tab	将焦点移到前一个对象。
Tab 键	将焦点移到下一个对象。

在需要多行文本字段的任何地方都可使用 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 组件的应用程序，请执行以下步骤：

将 TextArea 组件从“组件”面板拖到舞台上。
在属性检查器中，输入实例名称 comment。
在属性检查器中，按照需要设置参数。但是，请将文本参数保留为空，将可编辑参数设为 true，将密码参数设为 false。

在时间轴中选择第一帧，打开“动作”面板，然后输入以下代码：

textListener = new Object();
textListener.handleEvent = function (evt){
  if (comment.length < 1)  {     
  Alert(_root, "错误", "您必须在此字段中至少输入一个注释", mxModal | mxOK); 
  }
}
comment.addEventListener("focusOut", textListener);

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

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