Functional and Design Specification

Glossary

TLF The Text Layout Framework library provides text editing with high-quality international typography and layout. It builds on the Flash Text Engine (FTE) introduced in Flash Player 10.

Summary and Background

TLF is the base text engine used by all Spark text components, including TextInput, TextArea, RichText, and RichEditableText. TLF 2.0 focuses on improving performance of text in Flex applications as well as adding some new features like bulleted and numbered lists and support for floating images. In the Flex 4.5 time frame our main goal for text is better performance. Most of this will come from TLF2.0 and player support.

Usage Scenarios

A developer wishes to include a bulleted or numbered list in his TextArea component.

A developer wishes to control how text flows around an image in his RichEditableText component.

Detailed Description

TLF 2.0 Lists is a good introduction to TLF's new support for bulleted and numbered lists.

Floats are used when you have an image, and you would like the text to wrap around it.

TLF's highest priority features for Version 2 are as follows:

TLF Feature
Flex Task

Performance Enhancements
free

Support for Floats

Support for Lists

Support for new wordSpacing style
add wordSpacing style

Support for new leadingModel style type
add LeadingModel.BOX type to leadingModel style

Support for new SubParagraphGroupElement tag

Soft Keyboard (player)
free

ContextMenu

Caveat: spark Label will not support any of the new formats or flow elements.

API Description

Not applicable.

A- Features

none

Examples and Usage

    <s:TextArea id="myTextArea">
        <s:content>
            <s:p>This is an example of a simple list.</s:p>
            <s:list >
                <s:li><s:p>one</s:p></s:li>
                <s:li><s:p>two</s:p></s:li>
                <s:li><s:p>three</s:p></s:li>
            </s:list>
        </s:content>
    </s:TextArea>

    <s:RichEditableText id="myRET" width="200">
        <s:textFlow>
            <s:TextFlow>
                <s:p>
                    This is a paragraph that has
                    <s:img source="myImage.png" float="none"/>
                    an image inline that has float set to none.
                </s:p>
                <s:p>
                    This is a paragraph that has
                    <s:img source="myImage.png" float="left"/>
                    an image inline that has float set to left.
                </s:p>
                <s:p>
                    This is a paragraph that has
                    <s:img source="myImage.png" float="right"/>
                    an image inline that has float set to end.
                </s:p>
            </s:TextFlow>
        </s:textFlow>
    </s:RichEditableText>

See the TLF blog for more examples of usage.

Additional Implementation Details

Not applicable.

Compiler Work

Not applicable.

Backwards Compatibility

Syntax changes

Not applicable.

Behavior

Not applicable.

Warnings/Deprecation

Not applicable.

Accessibility

Not applicable.

Performance

Not applicable.

Globalization

Not applicable.

Localization

Compiler Features

Not applicable.

Framework Features

Not applicable.

Cross-Platform Considerations

Not applicable.

Issues and Recommendations

Not applicable.

\