spark.components.Label

Label 是可以呈示一行或多行统一格式文本的低级 UIComponent。要显示的文本由从 TextBase 继承的 text 属性确定。文本格式由元素的 CSS 样式指定，例如 fontFamily 和 fontSize。

Spark 体系结构提供三个文本“原型”（Label、RichText 和 RichEditableText）作为其“仅在用户需要时支付”基本原理的一部分。Label 运行速度最快且占用内存最少，但其功能有限：无复杂格式、不可滚动、不可选择、不可编辑且无超链接。RichText 和 RichEditableText 基于 Text Layout Framework (TLF) 库，而不是 FTE。RichText 新增了使用复杂格式程示 HTML 等富文本的功能，但仍然完全是非交互式的。您应该使用能够满足需求的最快速的文本原型。

• 与 MX Label 相比，Spark Label 可提供更佳的印刷效果，且能更好地支持各国语言。
• Spark Label 可以显示多行，但 MX Label 不可以。
• MX Label 可以显示 HTML 的有限子集，但 Spark Label 只能显示统一格式的文本。

?

在 Spark Label 中，将以下三个字符序列识别为显式换行符：CR（“\r”）、LF（“\n”）和 CR+LF（“\r\n”）。

如果确实指定了某种类型的宽度，则指定的文本将在组件边界的右边缘换行，因为 lineBreak 样式的默认值为“toFit”。

要禁用此自动换行，请将 lineBreak 样式设置为“explicit”。

如果文本超出了显示这些文本的空间，Label 可以截断文本。截断文本意味着使用截断指示符（如 “…”）替换超额文本。请参阅继承的属性 maxDisplayedLines 和 isTruncated。

可以使用 lineHeight 样式控制行间距。可以使用 textAlign、textAlignLast 和 verticalAlign 样式水平和垂直对齐元素范围内的文本。可以使用 paddingLeft、paddingTop、paddingRight 和 paddingBottom 样式从元素边缘插入文本。

默认情况下，Label 没有背景，但是可以使用 backgroundColor 和 backgroundAlpha 样式绘制一个背景。不支持边框。如果需要边框或更复杂的背景，请在 Label 后面使用单独的图形元素，例如 Rect。

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

Label 在 Flash Text Engine 中使用 TextBlock 类创建一个或多个 TextLine 对象，以采用由其 CSS 样式确定的格式静态显示其文本 String。由于性能原因，其 TextLine 不包含有关各个字型的信息；有关更多信息，请参阅 flash.text.engine.TextLineValidity.STATIC。

默认 MXML 属性: text

另请参阅:

spark.components.RichEditableText

spark.components.RichText

语言版本:

3.0

Player 版本:

Flash 10, AIR 1.5

产品版本:

Flex 4

相关笔记

• Flex应用开发步骤详解（Flex程序开发步骤）
• Flex CSS样式的四种声明方法
• 使用FlexAIR去除窗口的边框、菜单栏
• 解读Flex通信方法(详细)
• FLEX学习教程学习资料，视频教程，学习手册，教程下载网址整理