ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Using the TextField class
Displaying HTML text
Flash Player 9 and later, Adobe AIR 1.0 and later
The flash.text.TextField class has an htmlText property that you can use to identify your text string as one containing
HTML tags for formatting the content. As in the following example, you must assign your string value to the htmlText
property (not the text property) for Flash Player or AIR to render the text as HTML:
var myText:String = "This is some content to render as HTML text.";
myTextBox.htmlText = myText;
Flash Player and AIR support a subset of HTML tags and entities for the htmlText property. The
flash.text.TextField.htmlText property description in the ActionScript 3.0 Reference provides detailed
information about the supported HTML tags and entities.
Once you designate your content using the htmlText property, you can use style sheets or the textformat tag to
manage the formatting of your content. For more information, see “Formatting text” on page 380.
Using images in text fields
Flash Player 9 and later, Adobe AIR 1.0 and later
Another advantage to displaying your content as HTML text is that you can include images in the text field. You can
reference an image, local or remote, using the img tag and have it appear within the associated text field.
The following example creates a text field named myTextBox and includes a JPG image of an eye, stored in the same
directory as the SWF file, within the displayed text:
package
{
import flash.display.Sprite;
import flash.text.*;
public class TextWithImage extends Sprite
{
private var myTextBox:TextField;
private var myText:String = "This is some content to test and
seewhat can be
rendered.You should see an eye image and some HTML text.";
}
}
public function TextWithImage()
{
myTextBox.width = 200;
myTextBox.height = 200;
myTextBox.multiline = true;
myTextBox.wordWrap = true;
myTextBox.border = true;
}
addChild(myTextBox);
myTextBox.htmlText = myText;
The img tag supports JPEG, GIF, PNG, and SWF files.
Last updated 6/6/2012
375