• toFit (LineBreak.TO_FIT): For lines that wrap to fit to the container width.
• explicit (LineBreak.EXPLICIT): For lines that break only at explicit return/line feeds.

Full code after the jump.

The following example(s) require Flash Player 10 and the Adobe Flex 4 SDK. To download the Adobe Flash Builder 4 trial, see http://www.adobe.com/products/flex/. To download the latest nightly build of the Flex 4 SDK, see http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4.
For more information on getting started with Flex 4 and Flash Builder 4, see the official Adobe Flex Team blog.

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/02/04/setting-word-wrapping-on-the-fxtextarea-control-in-flex-gumbo/ -->
<s:Application name="Spark_TextArea_lineBreak_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo">

    <mx:ApplicationControlBar cornerRadius="0" width="100%">
        <mx:Form styleName="plain">
            <mx:FormItem label="lineBreak:">
                <s:DropDownList id="comboBox" requiresSelection="true">
                    <s:dataProvider>
                        <s:ArrayList source="[toFit,explicit]" />
                    </s:dataProvider>
                </s:DropDownList>
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <s:TextArea id="textArea"
            lineBreak="{comboBox.selectedItem}"
            fontSize="16"
            horizontalCenter="0"
            verticalCenter="0">
        <s:content>
            <s:p>1. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>2. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>3. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>4. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>5. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>6. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>7. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>8. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>9. The quick brown fox jumps over the lazy dog.</s:p>
        </s:content>
    </s:TextArea>

</s:Application>

You can also set the lineBreak style in an external .CSS file or <Style> block, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/02/04/setting-word-wrapping-on-the-fxtextarea-control-in-flex-gumbo/ -->
<s:Application name="Spark_TextArea_lineBreak_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo">

    <fx:Style>
        @namespace s "library://ns.adobe.com/flex/spark";

        s|TextArea {
            lineBreak: explicit;
        }
    </fx:Style>

    <s:TextArea id="textArea"
            fontSize="16"
            horizontalCenter="0"
            verticalCenter="0">
        <s:content>
            <s:p>1. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>2. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>3. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>4. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>5. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>6. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>7. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>8. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>9. The quick brown fox jumps over the lazy dog.</s:p>
        </s:content>
    </s:TextArea>

</s:Application>

Or, you can set the lineBreak style using ActionScript, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/02/04/setting-word-wrapping-on-the-fxtextarea-control-in-flex-gumbo/ -->
<s:Application name="Spark_TextArea_lineBreak_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo">
    <fx:Script>
        <![CDATA[
            import mx.events.IndexChangedEvent;

            private function comboBox_selectionChanged(evt:IndexChangedEvent):void {
                textArea.setStyle("lineBreak", comboBox.selectedItem);
            }
        ]]>
    </fx:Script>

    <mx:ApplicationControlBar cornerRadius="0" width="100%">
        <mx:Form styleName="plain">
            <mx:FormItem label="lineBreak:">
                <s:DropDownList id="comboBox"
                        requiresSelection="true"
                        selectionChanged="comboBox_selectionChanged(event);">
                    <s:dataProvider>
                        <s:ArrayList source="[toFit,explicit]" />
                    </s:dataProvider>
                </s:DropDownList>
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <s:TextArea id="textArea"
            fontSize="16"
            horizontalCenter="0"
            verticalCenter="0">
        <s:content>
            <s:p>1. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>2. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>3. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>4. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>5. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>6. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>7. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>8. The quick brown fox jumps over the lazy dog.</s:p>
            <s:p>9. The quick brown fox jumps over the lazy dog.</s:p>
        </s:content>
    </s:TextArea>

</s:Application>

Due to popular demand, here is the “same” example in a more ActionScript friendly format:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/02/04/setting-word-wrapping-on-the-fxtextarea-control-in-flex-gumbo/ -->
<s:Application name="Spark_TextArea_lineBreak_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo"
        initialize="init();">

    <fx:Script>
        <![CDATA[
            import flashx.textLayout.formats.LineBreak;

            import mx.collections.ArrayList;
            import mx.containers.ApplicationControlBar;
            import mx.containers.Form;
            import mx.containers.FormItem;
            import mx.events.IndexChangedEvent;
            import spark.components.DropDownList;
            import spark.components.TextArea;

            private var comboBox:DropDownList;
            private var textArea:TextArea;

            private function init():void {
                var arr:Array = [LineBreak.TO_FIT, LineBreak.EXPLICIT];

                comboBox = new DropDownList();
                comboBox.dataProvider = new ArrayList(arr);
                comboBox.requiresSelection = true;
                comboBox.addEventListener(IndexChangedEvent.SELECTION_CHANGED, comboBox_change);

                var formItem:FormItem = new FormItem();
                formItem.label = "lineBreak:";
                formItem.addChild(comboBox);

                var form:Form = new Form();
                form.styleName = "plain";
                form.addChild(formItem);

                var appControlBar:ApplicationControlBar = new ApplicationControlBar();
                appControlBar.dock = true;
                appControlBar.percentWidth = 100;
                appControlBar.setStyle("cornerRadius", 0);
                appControlBar.addChild(form);
                addElementAt(appControlBar, 0);

                var c:XML = <TextFlow xmlns="http://ns.adobe.com/textLayout/2008">
                        <p>1. The quick brown fox jumps over the lazy dog.</p>
                        <p>2. The quick brown fox jumps over the lazy dog.</p>
                        <p>3. The quick brown fox jumps over the lazy dog.</p>
                        <p>4. The quick brown fox jumps over the lazy dog.</p>
                        <p>5. The quick brown fox jumps over the lazy dog.</p>
                        <p>6. The quick brown fox jumps over the lazy dog.</p>
                        <p>7. The quick brown fox jumps over the lazy dog.</p>
                        <p>8. The quick brown fox jumps over the lazy dog.</p>
                        <p>9. The quick brown fox jumps over the lazy dog.</p>
                    </TextFlow>;

                textArea = new TextArea();
                textArea.content = c;
                textArea.setStyle("fontSize", 16);
                textArea.horizontalCenter = 0;
                textArea.verticalCenter = 0;
                addElement(textArea);
            }

            private function comboBox_change(evt:IndexChangedEvent):void {
                textArea.setStyle("lineBreak", comboBox.selectedItem);
            }
        ]]>
    </fx:Script>

</s:Application>

Also, if you were using plain text instead of HTML formatted text (using the <p> and/or <br> tags) you would set the text property and use the “\n” escape sequence to create new lines, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/02/04/setting-word-wrapping-on-the-fxtextarea-control-in-flex-gumbo/ -->
<s:Application name="Spark_TextArea_lineBreak_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo"
        initialize="init();">

    <fx:Script>
        <![CDATA[
            import flashx.textLayout.formats.LineBreak;

            import mx.collections.ArrayList;
            import mx.containers.ApplicationControlBar;
            import mx.containers.Form;
            import mx.containers.FormItem;
            import mx.events.IndexChangedEvent;
            import spark.components.DropDownList;
            import spark.components.TextArea;

            private var comboBox:DropDownList;
            private var textArea:TextArea;

            private function init():void {
                var arr:Array = [LineBreak.TO_FIT, LineBreak.EXPLICIT];

                comboBox = new DropDownList();
                comboBox.dataProvider = new ArrayList(arr);
                comboBox.requiresSelection = true;
                comboBox.addEventListener(IndexChangedEvent.SELECTION_CHANGED, comboBox_change);

                var formItem:FormItem = new FormItem();
                formItem.label = "lineBreak:";
                formItem.addChild(comboBox);

                var form:Form = new Form();
                form.styleName = "plain";
                form.addChild(formItem);

                var appControlBar:ApplicationControlBar = new ApplicationControlBar();
                appControlBar.dock = true;
                appControlBar.percentWidth = 100;
                appControlBar.setStyle("cornerRadius", 0);
                appControlBar.addChild(form);
                addElementAt(appControlBar, 0);

                var c:String = "1. The quick brown fox jumps over the lazy dog.\\n" +
                        "2. The quick brown fox jumps over the lazy dog.\\n" +
                        "3. The quick brown fox jumps over the lazy dog.\\n" +
                        "4. The quick brown fox jumps over the lazy dog.\\n" +
                        "5. The quick brown fox jumps over the lazy dog.\\n" +
                        "6. The quick brown fox jumps over the lazy dog.\\n" +
                        "7. The quick brown fox jumps over the lazy dog.\\n" +
                        "8. The quick brown fox jumps over the lazy dog.\\n" +
                        "9. The quick brown fox jumps over the lazy dog.";

                textArea = new TextArea();
                textArea.text = c;
                textArea.setStyle("fontSize", 16);
                textArea.horizontalCenter = 0;
                textArea.verticalCenter = 0;
                addElement(textArea);
            }

            private function comboBox_change(evt:IndexChangedEvent):void {
                textArea.setStyle("lineBreak", comboBox.selectedItem);
            }
        ]]>
    </fx:Script>

</s:Application>

This entry is based on a beta version of the Flex 4 SDK and therefore is very likely to change as development of the Flex SDK continues. The API can (and will) change causing examples to possibly not compile in newer versions of the Flex 4 SDK.

 

Full code after the jump.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/05/31/setting-the-leading-on-a-text-control-in-flex/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="top"
        backgroundColor="white">

    <mx:Script>
        <![CDATA[
            private function init():void {
                slider.value = txt.getStyle("leading");
            }
        ]]>
    </mx:Script>

    <mx:String id="lorem" source="lorem.txt" />

    <mx:ApplicationControlBar dock="true">
        <mx:Form styleName="plain">
            <mx:FormItem label="leading:" direction="horizontal">
                <mx:HSlider id="slider"
                        minimum="0"
                        maximum="10"
                        snapInterval="1"
                        tickInterval="1"
                        liveDragging="true" />
                <mx:Label text="{slider.value}" />
            </mx:FormItem>
            <mx:FormItem label="height:">
                <mx:Label text="{txt.height}" />
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <mx:Text id="txt"
            text="{lorem}"
            leading="{slider.value}"
            textAlign="justify"
            width="400"
            preinitialize="init();" />

</mx:Application>

View source is enabled in the following example.

You can also set the leading style using an external .CSS file or <mx:Style /> block, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/05/31/setting-the-leading-on-a-text-control-in-flex/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="top"
        backgroundColor="white">

    <mx:Style>
        Text {
            leading: 12;
        }
    </mx:Style>

    <mx:Script>
        <![CDATA[
            private function init():void {
                lbl.text = txt.getStyle("leading");
            }
        ]]>
    </mx:Script>

    <mx:String id="lorem" source="lorem.txt" />

    <mx:ApplicationControlBar dock="true">
        <mx:Form styleName="plain">
            <mx:FormItem label="leading:">
                <mx:Label id="lbl" creationComplete="init();" />
            </mx:FormItem>
            <mx:FormItem label="height:">
                <mx:Label text="{txt.height}" />
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <mx:Text id="txt"
            text="{lorem}"
            textAlign="justify"
            width="400" />

</mx:Application>

Or, you can set the leading style using ActionScript, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/05/31/setting-the-leading-on-a-text-control-in-flex/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="top"
        backgroundColor="white">

    <mx:Script>
        <![CDATA[
            import mx.events.SliderEvent;

            private function init():void {
                slider.value = txt.getStyle("leading");
            }

            private function slider_change(evt:SliderEvent):void {
                txt.setStyle("leading", evt.value);
            }
        ]]>
    </mx:Script>

    <mx:String id="lorem" source="lorem.txt" />

    <mx:ApplicationControlBar dock="true">
        <mx:Form styleName="plain">
            <mx:FormItem label="leading:" direction="horizontal">
                <mx:HSlider id="slider"
                        minimum="0"
                        maximum="10"
                        snapInterval="1"
                        tickInterval="1"
                        liveDragging="true"
                        change="slider_change(event);" />
                <mx:Label text="{slider.value}" />
            </mx:FormItem>
            <mx:FormItem label="height:">
                <mx:Label text="{txt.height}" />
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <mx:Text id="txt"
            text="{lorem}"
            textAlign="justify"
            width="400"
            preinitialize="init();" />

</mx:Application>