学步园

 

Flash Player 支持以下 HTML 标签：

标签	说明
锚标签	<a> 标签创建超文本链接并支持以下属性： target：指定加载页面的目标窗口的名称。选项包括 _self、_blank、_parent 和 _top。_self 选项指定当前窗口中的当前帧，_blank 指定一个新窗口，_parent 指定当前帧的父级，而 _top 指定当前窗口中的顶级帧。 href：指定 URL 或 ActionScript link 事件。URL 可以是绝对路径或相对路径（相对于加载页的 SWF 文件的位置）。http://www.adobe.com 示例表示对 URL 的绝对引用；/index.html 示例表示相对引用。绝对 URL 必须以 http:// 为前缀，否则 Flash Player 或 AIR 会将其视为相对 URL。可以使用 link 事件使链接执行 SWF 文件中的 ActionScript 函数，而不是打开 URL。要指定 link 事件，请在 href 属性中使用 event 方案，而不是 http 方案。例如，使用href="event:myText" 而不是 href="http://myURL"；当用户单击包含 event 方案的超文本链接时，文本字段将调度 link TextEvent，并将其 text 属性设置为“myText”。可随后创建一个 ActionScript 函数，每次调度 link TextEvent 时都会执行该函数。还可以使用样式表为锚标签定义 a:link、a:hover 和a:active 样式。
粗体标签	<b> 标签以粗体形式呈现文本。粗体必须可用于所使用的字体。
换行标签	<br> 标签将在文本字段中创建一个换行符。将文本字段设置为多行文本字段以使用此标签。
字体标签	<font> 标签指定一种字体或一个字体列表来显示文本。字体标签支持以下属性： color：只支持十六进制颜色 (#FFFFFF) 值。 face：指定要使用的字体的名称。如下例所示，您可以指定一个以逗号分隔的字体名称的列表，在这种情况下，Flash Player 选择第一个可用字体。如果本地计算机系统上未安装指定的字体，或 SWF 文件中未嵌入指定的字体，则 Flash Player 将选择替代字体。 size：指定字体的大小。您可以使用绝对像素大小（如 16 或 18），也可以使用相对点值（如 +2 或 -4）。
图像标签	使用 <img> 标签可将外部图像文件（JPEG、GIF、PNG）、SWF 文件和影片剪辑嵌入到文本字段中。在文本字段中，文本在嵌入的图像旁自动换行。您必须将文本字段设置为多行才能在图像周围绕排文本。 <img> 标签支持以下属性： src：指定图像或 SWF 文件的 URL，或库中影片剪辑元件的链接标识符。此属性是必需的，所有其他属性都是可选的。外部文件（JPEG、GIF、PNG 和 SWF 文件）只有在完全下载之后才能显示。 width：所插入的图像、SWF 文件或影片剪辑的宽度（以像素为单位）。 height：所插入的图像、SWF 文件或影片剪辑的高度（以像素为单位）。 align：指定文本字段中嵌入图像的水平对齐方式。有效值为 left 和 right。默认值为 left。 hspace：指定图像周围不显示任何文本的水平空间量。默认值为 8。 vspace：指定图像周围不显示任何文本的垂直空间量。默认值为 8。 id：指定包含嵌入的图像文件、SWF 文件或影片剪辑的影片剪辑实例（由 Flash Player 创建）的名称。此方法可用于使用 ActionScript 控制嵌入的内容。 checkPolicyFile：指定 Flash Player 将在与图像域相关的服务器上查找 URL 策略文件。如果存在策略文件，则此文件中列出的域中的 SWF 文件可以访问所加载的图像的数据，例如，通过使用此图像作为 source 参数来调用 BitmapData.draw() 方法。有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：安全性。 Flash 以完全大小显示文本字段中嵌入的媒体。要指定嵌入的媒体的尺寸，请使用 <img> 标签的 height 和 width 属性。 通常情况下，文本字段中嵌入的图像显示在 <img> 标签后的行上。但是，如果 <img> 标签是文本字段中的第一个字符，则该图像显示在文本字段的第一行上。 对于应用程序安全沙箱中的 AIR 内容，AIR 会忽略 ActionScript TextField 对象的 HTML 内容中的 img 标签。这是为了防止可能发生的仿冒攻击，
斜体标签	<i> 标签以斜体形式显示标签中的文本。斜体必须可用于所使用的字体。
列表项标签	<li> 标签在所包含的文本前放置项目符号。注意：因为 Flash Player 和 AIR 无法识别有序和无序列表标签（<ol> 和 <ul>），所以这些标签无法修改列表的呈现方式。所有列表都是无序的，所有列表项都使用项目符号。
段落标签	<p> 标签创建一个新段落。必须将文本字段设置为多行文本字段才能使用此标签。<p> 标签支持以下属性： align：指定段落内文本的对齐方式；有效值为 left、right、justify 和 center。 class：指定 flash.text.StyleSheet 对象定义的 CSS 样式类。
Span 标签	<span> 标签只可用于 CSS 文本样式。它支持以下属性： class：指定 flash.text.StyleSheet 对象定义的 CSS 样式类。
文本格式标签	使用 <textformat> 标签可在文本字段中使用 TextFormat 类的段落格式设置属性的子集，其中包括行距、缩进、边距和 Tab 停靠位。您可以将 <textformat> 标签与内置 HTML 标签结合使用。 <textformat> 标签具有以下属性： blockindent：指定块缩进（以点为单位）；对应于 TextFormat.blockIndent。 indent：指定从左边距到段落中第一个字符的缩进；对应于 TextFormat.indent。正数和负数均可以接受。 leading：指定行与行之间的前导量（垂直间距）；对应于 TextFormat.leading。正数和负数均可以接受。 leftmargin：指定段落的左边距（以点为单位）；对应于 TextFormat.leftMargin。 rightmargin：指定段落的右边距（以点为单位）；对应于 TextFormat.rightMargin。 tabstops：将自定义 Tab 停靠位指定为一个非负整数的数组；对应于 TextFormat.tabStops。
下划线标签	<u> 标签为标签文本添加下划线。

Flash Player 和 AIR 支持以下 HTML 实体：

实体	说明
&lt;	<（小于）
&gt;	>（大于）
&amp;	&（and 符）
&quot;	"（双引号）
&apos;	'（撇号，单引号）

Flash Player 和 AIR 还支持显式字符代码，如 &（ASCII 和号）和 €（Unicode € 符号）。

 

实现 
    public function get htmlText():String
    public function set htmlText(value:String):void

相关 API 元素

flash.text.TextField.text
flash.text.StyleSheet
flash.events.TextEvent

示例  ( 如何使用本示例 ) 

下例创建一个名为 tf1 的 TextField，并将 HTML 格式的字符串赋给其 text 属性。当跟踪其 htmlText 属性时，输出为 HTML 格式的字符串，带有由 Flash Player 自动添加的其他标签（如 <P> 和 <FONT>）。当跟踪 text 属性的值时，将显示不带 HTML 标签的无格式字符串。

为了进行比较，我们对另一个名为 tf2 的 TextField 对象执行了同样的步骤，并在设置 tf2 的 htmlText 属性之前将 StyleSheet 对象赋给它的 styleSheet 属性。在这种情况下，当跟踪 htmlText 属性时，它只包括最初赋给 htmlText 属性的 HTML 文本，说明 Flash Player 没有添加其他标签。

 

package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;

    public class TextField_text extends Sprite {
        public function TextField_text() {
            var tf1:TextField = createCustomTextField(10, 10, 400, 22);
            tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";

            // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P>
            trace("htmlText: " + tf1.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf1.text);
            
            var tf2:TextField = createCustomTextField(10, 50, 400, 22);
            tf2.styleSheet = new StyleSheet();
            tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";
            // htmlText: <b>Lorem ipsum dolor sit amet.</b>
            trace("htmlText: " + tf2.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf2.text);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}