18.5.1. <B> (Bold)

<B>This is bold text</B>

18.5.2. <I> (Italics)

<I>This is italic text</I>

18.5.3. <U> (Underline)

<U>This is underlined text</U>

Because linked text is not underlined in Flash, you should use the <U> tag to identify hyperlinks:

<A HREF="http://www.thesquarerootof-1.com"><U>Click here</U>
</A> to visit a neat site.

18.5.4. <FONT> (Font Control)

Here are some <FONT> examples:

<FONT FACE="Arial">this is Arial</FONT>
<FONT FACE="Arial" SIZE="12">this is 12pt Arial</FONT>
<FONT FACE="Lucida Console" SIZE="+4" COLOR="#FF0000">this is red, 
+4pt Lucida Console</FONT>

18.5.5. <P> (Paragraph Break)

I hate filling out forms. <P>So sometimes I don't.
// Flash output:
I hate filling out forms. So sometimes I don't.
// Web browser output:
I hate filling out forms.
So sometimes I don't.

Closing </P> tags are required by Flash in order for line breaks to be added. For example:

<P> I hate filling out forms.</P> So sometimes I don't.

Furthermore, in Flash, <P> causes a single line break, exactly like <BR>, whereas in web browsers, <P> traditionally causes a double line break. Consider the following:

<P>This is line one.</P><P>This is line two.</P>

In Flash, that code would be rendered with no gap between the lines, as in:

This is line one.
This is line two.

In a web browser, the code would be rendered with a gap between the lines, as in:

This is line one.

This is line two.

Because Flash's <P> tag behavior differs from web browsers, we often use the <BR> tag instead. However, the ALIGN attribute of the <P> tag is still useful to center, right-justify, or left-justify text, as follows:

<P ALIGN="CENTER">Centered text</P>
<P ALIGN="RIGHT">Right-justified text</P>
<P ALIGN="LEFT">Left-justified text</P>

18.5.6. <BR> (Line Break)

This is line one. <BR>This is line two.
This is line one. \nThis is line two.

Both would be rendered in Flash as:

This is line one.
This is line two.

18.5.7. < A> (Anchor or Hypertext Link)

The generic syntax of the <A> tag is:

<A HREF="documentToLoad.html">linked text</A>

For example, to link to a good video game, we could use:

<A HREF="http://www.quake3arena.com/">nice game</A>

As with HTML, the URL can be absolute or relative to the current page. Normally, links followed via an anchor tag cause the current movie to be replaced with the document specified in the HREF of the anchor tag. However, an anchor tag may also cause a secondary browser window to launch. Using the TARGET attribute, we can specify the name of a window into which to load the linked document, as follows:

<A HREF="documentName" TARGET="windowName">linked text</A>

If a window named windowName does not already exist, the browser launches a new window and assigns it the name windowName. To launch each document in its own, anonymous window, we can use the _blank keyword, as in:

<A HREF="mypage.html" TARGET="_blank">linked text</A>

18.5.8. Anchor Tag Tab Order

18.5.9. Quoting Attribute Values

<P ALIGN=RIGHT>
<P ALIGN='RIGHT'>
<P ALIGN="RIGHT">

But in Flash, unquoted attribute values are not allowed. For example, the syntax <P ALIGN=RIGHT> is illegal in Flash. However, both single and double quotes may be used to delimit attribute values. When composing text field values that include HTML attributes, we must be careful to quote our attributes correctly, using one type of quote to demarcate the string itself and another to demarcate attribute values. For example:

// These examples are both valid
myText = "<P ALIGN='RIGHT'>hi there</P>";
myText = '<P ALIGN="RIGHT">hi there</P>';
// This example would cause an error because double quotation marks are
// used to demarcate both the string and the attribute
myText = "<P ALIGN="RIGHT">hi there</P>";

18.5.10. Unrecognized Tags and Attributes

<P>Please fill in and print this form</P>
<FORM><INPUT TYPE="TEXT"></FORM>
<P>Thank you!</P>

The output would be:

Please fill in and print this form
Thank you!

The FORM and INPUT elements are not supported by Flash so both are ignored. Similarly, if we use container elements such as <TD>, the content is preserved but the markup is ignored. For example:

myTextField = "<TABLE><TR><TD>table cell text</TD></TR></TABLE>";

outputs the following line without table formatting:

table cell text

18.5.11. Using HTML as Output

myTextField = "<P><B>Error!</B> You <I>must</I> supply an email address!</P>";

Embedding a font for an HTML text field embeds only a single style of a single font. For example, a text field set to bold Arial in the Character panel will only support characters of the Arial bold typeface. If we use HTML to assign a different style of Arial (such as italic) or a different typeface altogether (such as Garamond), the tagged text will be invisible unless the appropriate fonts are embedded with the movie!

Suppose, for example, that we create a text field called output. In the Character panel for our output text field we select Arial set to Italic. In the Text Options panel, we embed the entire Arial italic font. Then we set output to display HTML. Finally, we assign the following value to our text field:

output = '<P><I>My</I>, what <B>lovely</B>'
         + '<FONT SIZE="24">eyes</FONT> you have!</P>';

When the movie plays, the following text will appear in the text field:

My

Everything else we assigned to output is missing! Only the italic text in the HTML can be rendered. The rest of the text requires other variations of the Arial font that we didn't embed -- "what", "eyes", and "you have" are all nonitalic, and "lovely" is bold.

• Make a dummy text field, hidden from view, with the desired font selected in the Character panel and embedded in the Text Options panel.

• Add a new font symbol to the movie's Library and export the font with the movie.

Here are the steps for embedding Arial bold in a movie for use with a text field:

1. Select Window Library.

2. Select Options New Font. The Font Symbol Properties dialog box appears.

3. Under Font, select Arial.

4. Under Style, select Bold.

5. Under Name, type ArialBold (this is a cosmetic name, used only in the Library).

6. In the Library, select the ArialBold font symbol.

7. Select Options Linkage.

8. In the Symbol Linkage Properties dialog box, select Export This Symbol.

9. In the Identifier box, type ArialBold. For our purposes, the name we type here doesn't matter. Exported symbol identifiers are used only for shared libraries.

Note that every variation of a font style must be embedded individually. If we use Arial bold, Arial italic, and Arial bold italic in a text field, then we must embed all three font variations. Underline is not considered a font variation, nor is font size or color.

If, however, we do not enable any of the Embed Fonts options in the Text Options panel, then Flash relies entirely on the user's system for fonts, in which case normal, bold, and italic text will be rendered only if users have the appropriate font variant installed on their systems.

To ensure that text will display consistently across all platforms and user systems, you should embed all the fonts required for your text field.

18.5.12. Using HTML as Input

When regular text is entered into an HTML-enabled user-input text field, HTML markup tags are added automatically. For example, the text "Hi there" would be converted to the HTML value:

'<P ALIGN="LEFT"><FONT FACE="Arial" SIZE="10" COLOR="#000000">Hi there</FONT></P>'

When HTML tags are typed into an HTML-enabled user-input text field, the < and > characters are converted to &gt; and &lt;. For example, the text "<B>hi there</B>" would be converted to the value:

'<P ALIGN="LEFT"><FONT FACE="Arial" SIZE="10"
 COLOR="#000000">&lt;B&gt;hi there&lt;/B&gt;</FONT></P>'

HTML-enabled user-input text fields may be used to create a very simple HTML data entry system.

When regular or HTML text is typed into a normal (non-HTML) user-input text field, no modification of the entered text occurs. Regular user-input text fields allow raw HTML code to be entered into a movie without distortion.

An example showing HTML-enabled and regular user-input text field data entry is available from the online Code Depot.

18.5.13. Executing JavaScript from HTML Links

<A HREF="javascript:square(5);">find the square of 5</A>

myTextField = "<A HREF='javascript:alert(5);'>display the number 5</A>";

However, to include string values in JavaScript statements, we must use the HTML entity &quot; for quotation marks, as in:

myTextField = "<A HREF='javascript:alert(&quot;hello world&quot;);'>"
               + "display hello world</A>";

18.5.14. Calling ActionScript Functions from HTML Links

<A HREF="asfunction:myFunctionName">invoke the function</A>

The function invocation operator ( ) is not allowed and should not be used when invoking an ActionScript function from an anchor tag. In addition to calling an ActionScript function from an anchor tag, we may also pass one parameter to that function using the syntax:

<A HREF="asfunction:myFunctionName,myParameter">invoke the function</A>

where myParameter is the value of the parameter to pass. Inside the invoked function, myParameter is always a string. To pass more than one piece of information to a function from an anchor, we use a delimiter in the myParameter value and dissect the string ourselves in the function. For example, here's a function invocation that passes two values, separated by a | character, to the roleCall( ) function:

<A HREF="asfunction:roleCall,megan|murray">invoke the function</A>

And here's the roleCall( ) function. Notice how it separates the values with the split( ) method: