ACTIONSCRIPT 3 Developer’s Guide en

Chapter 59: Programming HTML and
JavaScript in AIR
Adobe AIR 1.0 and later
A number of programming topics are unique to developing Adobe® AIR® applications with HTML and JavaScript. The
following information is important whether you are programming an HTML-based AIR application or programming
a SWF-based AIR application that runs HTML and JavaScript using the HTMLLoader class (or mx:HTML Flex
component).
About the HTMLLoader class
Adobe AIR 1.0 and later
The HTMLLoader class of Adobe AIR defines the display object that can display HTML content in an AIR application.
SWF-based applications can add an HTMLLoader control to an existing window or create an HTML window that
automatically contains a HTMLLoader object with HTMLLoader.createRootWindow(). The HTMLLoader object
can be accessed through the JavaScript window.htmlLoader property from within the loaded HTML page.
Loading HTML content from a URL
Adobe AIR 1.0 and later
The following code loads a URL into an HTMLLoader object (add the HTMLLoader as a child of the stage or other
display object container to display the HTML content in your application):
import flash.html.HTMLLoader;
var html:HTMLLoader = new HTMLLoader;
html.width = 400;
html.height = 600;
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.load(urlReq);
An HTMLLoader object's width and height properties are both set to 0 by default. You will want to set these
dimensions when adding an HTMLLoader object to the stage. The HTMLLoader dispatches several events as a page
loads. You can use these events to determine when it is safe to interact with the loaded page. These events are described
in “Handling HTML-related events in AIR” on page 1017.
Note: In the Flex framework, only classes that extend the UIComponent class can be added as children of a Flex Container
components. For this reason, you cannot directly add an HTMLLoader as a child of a Flex Container component;
however you can use the Flex mx:HTML control, you can build a custom class that extends UIComponent and contains
an HTMLLoader as a child of the UIComponent, or you can add the HTMLLoader as a child of a UIComponent and add
the UIComponent to the Flex container.
Last updated 6/6/2012
978