Label  - AS3 Flex

指定是否应删除包含 HTML 文本的 Label 控件中的额外空白（空格、换行符等）。

condenseWhite 属性仅会对使用 htmlText 属性设置的文本产生影响，而不会对使用 text 属性设置的文本产生影响。如果使用 text 属性设置文本，则忽略 condenseWhite。

如果将 condenseWhite 属性设置为 true，您必须使用标准 HTML 命令（如 <br> 和 <p>）在文本字段中放置换行符。

默认值为 false;。

此属性可用作数据绑定的源。修改此属性后，将调度 condenseWhiteChanged 事件。

用于在项呈示器或项目编辑器中使用组件时将值传递给该组件。您通常使用数据绑定将 data 属性的字段绑定到此组件的某个属性。

将控件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 自动将项目的当前值写入此控件的 text 属性。

不要以 MXML 方式设置此属性。

默认值为 null。

此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。

相关 API 元素

为此组件提供字体上下文的模块工厂。

指定 Label 控件显示的文本，包括表示该文本样式的 HTML 标签。在此属性中指定 HTML 文本时，可以使用 Flash TextField 控件支持的 HTML 标记子集。

如果设置了此属性，则会在应用 Label 实例的 CSS 样式后应用 HTML 标记。获取此属性时，HTML 标记包括 CSS 样式。

例如，如果将此属性设置为 "This is an example of <b>bold</b> markup" 之类的字符串，则文本“This is an example of bold markup”将以通常应用的 CSS 样式在 Label 中进行显示。此外，由于存在 <b> 标记，“bold”一词将显示为粗体。

HTML 标记使用 < and > 等字符，这些字符在 XML 中具有特殊意义（在 MXML 中也同样如此）。所以，以下代码不能编译：

      <mx:Label htmlText="This is an example of <b>bold</b> markup"/>
      

有三种方法可以解决此问题。

• 在作为 initialize 处理函数调用的 ActionScript 方法中设置 htmlText 属性：

        <mx:Label id="myLabel" initialize="myLabel_initialize()"/>
        

  其中 myLabel_initialize 方法位于脚本 CDATA 节：

        <fx:Script>
        <![CDATA[
        private function myLabel_initialize():void {
            myLabel.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  由于 HTML 标记依然简单易读，因此这是最简单的方法。请注意，必须为标签分配 id，以便在 initialize 处理函数中引用它。

• 使用带有 CDATA 节的子标签指定 htmlText 属性。XML 中的 CDATA 节包含字符数据，其中 < 和 > 等字符不具有特殊意义。

        <mx:Label>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:Label/>
        

  您必须将 htmlText 属性编写为子标签，而不是 <mx:Label> 标签上的某一属性，因为 XML 不允许属性值中含有 CDATA。请注意，该标记可读性依然很好，但由于涉及到 CDATA 节，该方法比较复杂。

• 使用 hmtlText 属性，其中只要是 HTML 标记字符 < 和 >，在属性值中就会显示为 XML“实体”< 和 >：

        <mx:Label htmlText="This is an example of <b>bold</b> markup"/>
        

  由于使用此方法时 HTML 标记的可读性很差，因此 Adobe 不建议使用此方法。

设置 htmlText 属性时，如果 condenseWhite 属性为 true，将压缩多个空白字符（与基于 HTML 的浏览器中的情况类似），例如，三个连续的空格显示为一个空格。condenseWhite 的默认值为 false，因此，若要压缩空白字符，必须将 condenseWhite 设置为 true。

如果设置 htmlText 属性后立即重新读取该属性，将会看到设置的字符串。但是，如果 LayoutManager 开始运行，该值将发生更改，以包括包含 CSS 样式的其他标记。

设置 htmlText 属性将影响 text 属性的多个方面。如果设置 htmlText 属性后立即读取 text 属性，则您将收到 null，这表明尚未确定与新的 htmlText 相对应的 text。但是，LayoutManager 运行后，text 属性值将更改为 htmlText 字符串，且所有 HTML 标签已删除；也就是说此值为 Label 实际显示的字符。

反之，如果设置 text 属性，则先前设置的任何 htmlText 都将是不相关的。如果设置 text 属性后立即读取 htmlText 属性，则您将收到 null，这表明尚未确定与新的 text 相对应的 htmlText。但是，如果 LayoutManager 开始运行，htmlText 属性值更改为新的文本以及 CSS 样式的 HTML 标记。

要使 LayoutManager 立即运行，您可以对 Label 调用 validateNow() 方法。例如，您可以设置一些 htmlText，调用 validateNow() 方法，然后立即获得相应的不包含 HTML 标记的 text。

如果在 ActionScript 中设置 text 和 htmlText 两种属性，则最后设置的属性会生效。切勿在 MXML 中同时设置这两种属性，因为 MXML 不保证能够以特定顺序对实例的属性进行设置。

在某个循环内设置 text 或 htmlText 属性的操作完成得很快，因为实际呈示文本的基础 TextField 在 LayoutManager 运行后才更新。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。如果属性值暂时为 null，则表明刚刚设置了 text，但尚未确定相应的 htmlText。

默认值为 ""。

此属性可用作数据绑定的源。修改此属性后，将调度 htmlTextChanged 事件。

相关 API 元素

使用组件作为嵌入式项呈示器或嵌入式项目编辑器时，Flex 将使用 List 控件中的相应数据初始化该组件的 listData 属性。然后，组件可使用 listData 属性初始化嵌入式项呈示器或嵌入式项目编辑器的 data 属性。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项呈示器或嵌入式项目编辑器时，Flex 会对其进行设置。

默认值为 null。

此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。

相关 API 元素

指定是否可以选择文本。允许选择文本将使您能够从控件中复制文本。

在 Label 控件中指定 link 事件后，必须将 selectable 属性设置为 true 才能执行 link 事件。

默认值为 false;。

可呈示 Label 控件文本的 flash.text.StyleSheet 对象。使用此属性来详细控制文本的 HTML 样式。有关详细信息，请参阅 flash.text.StyleSheet 类文档。

默认值为 null。

相关 API 元素

指定由此控件显示的纯文本。其外观由此 Lable 控件的 CSS 样式确定。

当您设置此属性时，字符串中与 HTML 标记类似的字符没有任何特殊含义，将与输入时的显示一样。

要显示使用 HTML 标签格式化的文本，请改用 htmlText 属性。如果设置了 htmlText 属性，HTML 将替换使用此属性设置的所有文本，并且 text 属性将返回 HTML 文本的纯文本版本，而从中去除了所有 HTML 标签。

要在文本中包括特殊字符左尖括号 (<)、右尖括号 (>) 或和号 (&)，请将文本字符串包含在 CDATA 标签中。此外，您可以使用 HTML 字符实体表示特殊字符，例如 <。

如果此文本比 Label 控件宽，则将由省略号 (...) 截断并终止。当您将鼠标移动到 Label 控件上时，整个文本将作为工具提示显示。如果您也使用 tooltip 属性设置了工具提示，则显示工具提示而不显示文本。

如果尝试将此属性设置为 null，则该属性将设置为空字符串。text 属性可暂时使用值 null，此值表示刚刚设置了 htmlText 值，但相应的 text 值尚未确定。

默认值为 ""。

此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。

呈示此 Label 文本的内部 UITextField。

文本高度。

只有在组件经过验证后，textHeight 属性的值才是正确的。如果您在设置 text 后立即请求 textHeight，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

相关 API 元素

文本的宽度。

只有在组件经过验证后，textWidth 属性的值才是正确的。如果您在设置 text 后立即请求 textWidth，则接收到的值可能不正确。您应等待组件经过验证或调用 validateNow() 方法后，再获取此值。此行为与 flash.text.TextField 控件有所不同，后者会立即更新此值。

相关 API 元素

如果此属性为 true，并且 Label 控件大小小于其文本大小，则使用可本地化的字符串（如 "..."）截断 Label 控件的文本。如果此属性为 false，则将剪辑掉不适合的文本。

默认值为 true。

构造函数。

返回 TextLineMetrics 对象，其中包含控件中文本位置和文本行度量值的相关信息。必须对组件进行验证才能获得正确数值。如果设置 text 后立即调用 getLineMetrics()，则可能会获得不正确的值。您应该等待对组件进行验证或调用 validateNow()。此行为与 flash.text.TextField 类的行为不同，后者立即更新值。

参数

相关 API 元素

当 data 属性更改时进行调度。

当您使用组件作为项呈示器时，data 属性将包含要显示的数据。您可以侦听此事件，并在 data 属性更改时更新组件。

事件对象的属性有下列值：

当用户单击启用 HTML 文本字段中的超链接（其中的 URL 以 "event:" 开头）时调度。"event:" 之后 URL 的其余部分放置在 link 事件对象的 text 属性中。

处理 link 事件时，不会自动执行超链接；您需要从事件处理函数中执行超链接。通常使用 navigateToURL() 方法执行超链接。这允许您在应用程序中修改超链接，甚至禁止其运行。

Label 控件必须将 selectable 属性设置为 true，才能生成 link 事件。

此事件具有以下属性：