TextArea  - AS3 Flex

包	spark.components
类	public class TextArea
继承	TextArea SkinnableTextBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Spark 主题的外观使用 RichEditableText 类。这意味着，Spark TextArea 控件支持基于 Flash 文本引擎 (FTE) 的 Text Layout Framework (TLF) 库。组合后，可以在这些层上使用高质量的国际印刷效果和布局编辑文本。外观包括一个可以显示水平滚动条和垂直滚动条（用于滚动文本）的 Scroller，并支持使用鼠标滚轮垂直滚动。可以通过 textDisplay 形式访问 RichEditableText，通过 scroller 形式访问 Scroller。

Mobile 主题的外观使用 StyleableStageText 类。由于 StyleableStageText 使用本机文本字段，它可以在移动设备上实现更好的文本输入和操作体验，但您应该注意它有一些限制和差异。由于 StageText 不能度量文本，必须对 TextArea 给出显式、百分比形式或基于约束的 width 和 height。StyleableStageText 可以作为 textDisplay 访问。如果您希望使用基于 TextField 的外观而不是基于 StageText 的外观，请将 skinClass 属性设置为“spark.skins.mobile.TextAreaSkin”。

可以使用 text 属性设置要显示的文本或获取用户已输入的文本。

使用 CSS 样式（例如 fontFamily 和 fontSize）设置文本格式。

对于 Spark 主题，可以通过 widthInChars 和 heightInLines 属性以随字体大小缩放的方式指定 TextArea 的宽度和高度，也可以使用 typicalText 属性。请注意，如果使用 typicalText，则 widthInChars 和 heightInLines 属性将被忽略。对于所有主题，您也可以指定一个显式宽度或高度（以像素为单位），或者使用宽度和高度的百分比形式或约束，例如 left 和 right 或者 top 和 bottom。

可以使用 maxChars 属性限制用户可以输入的字符数，使用 restrict 限制用户可以输入的字符。要使用该控件输入密码，请将 displayAsPassword 属性设置为 true。

对于 Mobile 主题，特定于软键盘的属性 autoCapitalize、autoCorrect、returnKeyLabel 和 softKeyboardType 属性指定键盘提示。如果软键盘存在但它不支持提示表示的功能，则提示被忽略。在只有硬件键盘的移动环境中，这些提示将被忽略。

Spark 主题的文本区域

Spark TextArea 控件和 MX TextArea 控件之间的最重要区别如下所示：

• Spark TextArea 可提供更佳的印刷效果和文本布局，且能更好地支持各国语言。
• Spark TextArea 有面向对象模型的富文本，但 MX 版本却没有。
• 在显示大量文本时，Spark TextArea 性能表现得更好。
• Spark TextArea 嵌入字体的方式与 MX 版本不同。要了解如何在嵌入字体时使用 embedAsCFF 属性，请参阅“字体”文档。

Spark TextArea 控件使用 TLF 面向对象模型的富文本，其中，诸如分段、段落、范围、超链接和图像等文本布局元素在运行时由 ActionScript 对象表示。可以通过编程方式访问或操纵这些对象。TLF 中用于表示富文本的中心对象是 TextFlow。通过将 TextArea 控件的 textFlow 属性设置为 TextFlow 实例，来指定该控件的富文本。

如果不需要显示含有多种格式的文本，请将 TextArea 的 text 属性设置为纯文本字符串。有关 text 属性和 textFlow 属性如何进行交互（例如，可以设置一个属性，然后获取另一个属性）的信息，请参阅这两个属性的描述。

编译时，可以将 TLF 标记标签放在 TextArea 标签内，如下例所示：

  <s:TextArea>Hello <s:span fontWeight="bold">World!</s:span></s:TextArea>
  

TextArea 控件不包含任何用于更改文本格式的用户界面，但是包含可以用于以编程方式设置文本格式的 API。例如，可以创建一个按钮，当单击该按钮时，选定文本可变为粗体。

默认文本格式由 CSS 样式确定，例如 fontFamily 和 fontSize。TextFlow 对象中的任何格式信息都会覆盖 CSS 样式确定的默认格式。

可以使用样式控制 TextArea 内容的许多特征。以下是一些常用示例：

• 使用 lineHeight 样式控制行间距。
• 使用 paragraphSpaceBefore 和 paragraphSpaceAfter 样式控制段间距。
• 使用 textAlign 和 textAlignLast 样式将文本对齐或两端对齐。
• 使用 paddingLeft、paddingTop、paddingRight 和 paddingBottom 样式从控件的边框插入文本。

默认情况下，文本在控件的右边缘换行。如果文本超出了 TextArea 范围，会自动显示垂直滚动条。如果将 lineBreak 样式设置为 explicit，则仅在显式换行符处开始新行。如果在 text 中使用 CR (\r)、LF (\n) 或 CR+LF (\r\n)，或者在 TLF 标记中使用 <p> 和 <br/>，也会产生相同的效果。在这些情况下，如果任何文本行宽于控件，都会自动显示水平滚动条。

Spark TextArea 可以显示从左到右 (LTR) 书写的文本（如法语）、从右到左 (RTL) 书写的文本（如阿拉伯语）以及双向书写的文本（如阿拉伯语语句中的法语语句）。如果文本的主要书写方向为从右到左，请将 direction 样式设置为 rtl。textAlign 样式默认为 start，这样，当 direction 为 ltr 时，文本左对齐；当 direction 为 rtl 时，文本右对齐。要获得反向对齐，请将 textAlign 设置为 end。

Spark TextArea 还支持在一个编辑会话内执行无限次撤消/重做操作。编辑会话在控件获得键盘焦点时启动，在控件失去焦点时结束。

要在基于列表的组件（如 List 或 DataGrid）中使用此组件，请创建项呈示器。有关创建项呈示器的信息，请参阅自定义 Spark 项呈示器。

对于 Spark 主题，TextArea 控件具有以下默认特性：

对于 Mobile 主题，TextArea 控件具有以下默认特性：

显示 MXML 语法

隐藏 MXML 语法

  <s:TextArea
    Properties
    heightInLines="Calculated default"  [Spark theme only]
    textFlow="TextFlow"  [Spark theme only]
    typicalText=null  [Spark theme only]
    widthInChars="Calculated default"  [Spark theme only]
  
    Styles
    horizontalScrollPolicy="auto"  [Spark theme only]
    symbolColor=""
    verticalScrollPolicy="auto"  [Spark theme only]
  />
  

默认 MXML 属性content

查看示例

相关 API 元素