Introduction
The goal of this post is to give some information on TLF Markup. There is no DTD or other schema available at this time.
TLF Markup is converted to and from TextFlows using the TextConverter class. See the examples.
The attributes for TLF Markup are best documented on the TextLayoutFormat class page bundled with the Flex 4 documentation. Get the documentation appropriate to the build you downloaded gumbo from here. Select the download from the "Language Reference Download" column.
Elements
The elements in TLF markup are all in the flashx.textLayout.elements package. This table maps elements to TLF classes and lists their allowed children.
| XML Tag | AS3 Class | Allowed Children Elements/Notes |
|---|---|---|
| TextFlow | TextFlow | div, p, tcy, a, img, span, br, tab, format, linkNormalFormat, linkHoverFormat, linkActiveFormat, and raw text |
| div | DivElement | div, p, tcy, a, img, span, br, tab, linkNormalFormat, linkHoverFormat, linkActiveFormat, and raw text |
| p | ParagraphElement | tcy, a, img, span, br, tab, linkNormalFormat, linkHoverFormat, linkActiveFormat, and raw text |
| a | LinkElement | tcy, img, span, br, tab, linkNormalFormat, linkHoverFormat, linkActiveFormat, and raw text |
| linkNormalFormat | TextLayoutFormat | attributes overrides for link in normal state. |
| linkActiveFormat | TextLayoutFormat | attributes overrides for link in active state. |
| linkHoverFormat | TextLayoutFormat | attributes overrides for link in hover state. |
| tcy | TCYElement | a, img, span, br, tab, linkNormalFormat, linkHoverFormat, linkActiveFormat, and raw text |
| img | InlineGraphicElement | none allowed. see docs for additional attributes |
| span | SpanElement | br, tab and raw text |
| br | BreakElement | none allowed. Is normalized into a newline character by importer. |
| tab | TabElement | none allowed. Is normalized into a tab character by importer. |
| format | TextLayoutFormat | none allowed. See additional note. |
Format Element
The format element allows the markup to specify a format that can be referenced by other elements. For example:
<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">
<format id="english" fontFamily="Minion Pro"/>
<p><span>This is supposed to use the default font</span></p>
<p><span format="english">This is supposed to be in Minion Pro via a named format</span></p>
<p><span fontFamily="Minion Pro">This is supposed to be in Minion Pro via a fontFamily attribute</span></p>
</TextFlow>
NOTE: The attribute id in the format element is going to be changed to name. Check the ReleaseNotes posted with each TLF build.
Leave a comment