有些 Spark 文本控件已经过优化，适合在移动设备应用程序中使用。可能的情况下，请使用以下文本控件：

• Spark TextArea

• Spark TextInput

• Spark Label

在设备上使用 StageText 的优点是可获得以下功能（如果设备支持这些功能）：

• 本机性能以及软键盘的观感

• 自动完成

• 自动纠正

• 触控式文本选择

• 可自定义的软键盘

• 按键限制

创建移动设备应用程序时，Flex 将自动应用移动设备主题。因此，Spark TextInput 和 TextArea 控件默认情况下使用下列基于 StageText 的移动设备外观：

• StageTextAreaSkin

• StageTextInputSkin

StageTextAreaSkin 和 StageTextInputSkin 类已针对移动设备应用程序进行了优化，并且基于 StageTextSkinBase 类。它们充当本机文本输入类的包装器。但是，它们不支持非基于 TextField 外观的下列功能：

其中一些限制可通过使用基于 TextField 的版本来解决。要使用基于 TextField 版的文本输入控件，请将其外观类指向 TextField 版的 TextInputSkin 和 TextAreaSkin；例如：

<s:TextInput skinClass="spark.skins.mobile.TextInputSkin" text="TextField-based Skin"/>

在移动设备应用程序中应避免使用以下文本控件，因为它们使用 TLF 并且其外观未针对移动设备应用程序进行优化：

• Spark RichText

• Spark RichEditableText

当显示弹出窗口时，最顶层弹出窗口以外的基于 StageText 的文本输入将被替换为位图表示形式。因此：

• 使用模态弹出窗口，而不要使用非模态弹出窗口。当显示模态弹出窗口时，弹出窗口以外的组件将不再能够与用户交互。在这种情况下，使用位图替换 StageText 不太明显。

• 基于 StageText 的组件应当仅在实施 IFocusManagerContainer 接口的弹出窗口内使用。例如，使用 SkinnableContainer 或其派生类型之一作为弹出窗口的基础。

• 当较低层中的文本组件应保持活动状态时，使用 Callout 容器。如果文本组件中包含 Callout，该文本组件将保持活动状态并将 Callout 的箭头设置为指向该文本组件。这样可以自然地提示用户该文本组件仍然可以使用。

• 避免同时使用多个弹出窗口。如果同时有多个弹出窗口可见，仅可以与最顶层的弹出框口进行交互。但是，如果这些弹出窗口没有发生重叠，则用户将无法确定哪一个弹出窗口位于最顶层。

• 当非模态弹出窗口与文本控件重叠时，调整弹出窗口的位置以达到几乎完全重叠。如果用户看不到文本，他们将不太可能认为仍然可以与文本控件进行交互。

StageText 类（TextInput 和 TextArea）具有复杂的类层次结构。基础类自身具有下列层次结构：

    UIComponent 
        | 
SkinnableComponent 
        | 
SkinnableTextBase 
        | 
TextInput/TextArea

与所有 Spark 类一样，外观类有自己的层次结构：

    UIComponent 
        | 
    MobileSkin    StyleableStageText 
        |              | 
StageTextSkinBase: textDisplay 
        | 
StageTextInputSkin/StageTextAreaSkin

下例在移动设备应用程序中使用了一个简单的 Label 控件：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/SimpleLabel.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" title="Simple Label">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>
    
    <s:layout>
        <s:VerticalLayout/>
    </s:layout>
    
    <s:Label text="This is a simple Label control."/>
    
</s:View>

下例在移动设备应用程序中使用了一个 TextArea 控件：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/SimpleTextArea.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" 
        title="Simple TextArea">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>
    
    <s:layout>
        <s:VerticalLayout/>
    </s:layout>

    <fx:Script>
        <![CDATA[
            // Note the use of \n to add line feeds/carriage returns
            // and \" to add quotation marks.
            [Bindable]
            public var myText:String ="\"Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.\"\n\n\"Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.\"";
        ]]>
    </fx:Script>
    
    <!-- Basic TextArea control with multiple lines of text. -->
    <s:TextArea id="myTA" height="75%" text="{myText}" 
                paddingLeft="20" paddingTop="20" 
                paddingRight="20" paddingBottom="20"/>
        
</s:View>

下例创建了一个与应用程序背景融合在一起的非交互式文本块：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/BlockOfText.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" title="Block of Text">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>
    
    <s:layout>
        <s:VerticalLayout/>
    </s:layout>

    <s:HGroup>
        <s:Image source="@Embed(source=‘../../assets/myImage.jpg‘)" width="30%"/>  
        <!-- Create a multi-line block of text. -->
        <s:TextArea width="65%" 
                editable="false" 
                borderVisible="false" 
                contentBackgroundColor="0xFFFFFF" 
                contentBackgroundAlpha="0" 
                height="400"
                text="Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat."/>
    </s:HGroup>
    
</s:View>

因为 TextArea 控件不支持 TLF，所以无法使用 textFlow、content 或 selectionHighlighting 属性。此外，也无法使用以下方法：

• getFormatOfRange()

• setFormatOfRange()

下例显示了在移动设备应用程序中具有提示文本和自定义焦点外框的 TextInput 控件：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/SimpleTextInput.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" title="Simple TextInput">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>
    
    <s:layout>
        <s:VerticalLayout 
            paddingTop="20" 
            paddingLeft="20" 
            paddingRight="20"/>
    </s:layout>
    
    <s:TextInput 
        prompt="Enter text here" 
        focusColor="green" 
        focusThickness="5" 
        focusAlpha=".1"/>
    <s:TextInput 
        prompt="Enter text here, too" 
        focusColor="red" 
        focusThickness="5" 
        focusAlpha=".1"/>

</s:View>

以下是移动设备应用程序中 TextInput 和 TextArea 支持的仅有的几个样式：

• color

• contentBackgroundAlpha

• contentBackgroundColor

• 焦点外框样式：focusAlpha、focusBlendMode、focusColor 和 focusThickness

• fontFamily

• fontStyle

• fontSize

• fontWeight

• locale

• 内边距样式：paddingBottom、paddingLeft、paddingRight 和 paddingTop

• showPromptWhenFocused

• textAlign

下例显示了根据 fontFamily 样式的值呈现文本的方式：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/FontFamilyExample.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" title="The fontFamily style">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>

    <s:layout>
        <s:VerticalLayout/>
    </s:layout>

    <s:TextInput prompt="This is _sans" fontSize="14" fontFamily="_sans"/>
    <s:TextInput prompt="This is _serif" fontSize="14" fontFamily="_serif"/>
    <s:TextInput prompt="This is _typewriter" fontSize="14" fontFamily="_typewriter"/>
    <s:TextInput prompt="This is Arial" fontSize="14" fontFamily="arial"/>
    <s:TextInput prompt="This is Times" fontSize="14" fontFamily="times"/>
    <s:TextInput prompt="This is Times New Roman" fontSize="14" fontFamily="Times New Roman"/>

    <!-- Try a gibberish font name to see what the device‘s default font is: -->
    <s:TextInput prompt="This is bugblatter" fontSize="14" fontFamily="bugblatter"/>

</s:View>

restrict 属性包含一系列允许使用的字符。对于范围，请使用连字符 (-)。不要以空格、逗号或其它字符分隔范围，除非您希望将该字符包含在定义中。下例显示了几个使用限制语法的示例：

<?xml version="1.0" encoding="utf-8"?>
<!-- mobile_text/views/RestrictStrings.mxml -->
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009" 
        xmlns:s="library://ns.adobe.com/flex/spark" title="Examples of restrict">
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>
    
    <s:layout>
        <s:VerticalLayout paddingTop="20" paddingLeft="20" paddingRight="20"/>
    </s:layout>
    
    <s:TextInput prompt="Alpha-numeric only" restrict="a-zA-Z0-9"/>

    <s:TextInput prompt="Numbers only" restrict="0-9"/>

    <s:TextInput prompt="All chars, only uppercase alpha" restrict="^a-z"/>

    <!-- ASCII chars 32 (space) through 126 (tilde) only: -->
    <s:TextInput prompt="" restrict="\u0020-\u007E"/>

    <s:TextInput prompt="All chars but not the caret or hyphen" restrict="^\^\-"/>

</s:View>

restrict 属性的字符串值从左向右读；脱字符 (^) 后的所有字符都是禁用字符。例如：

ta1.restrict = "A-Z^Q"; // All uppercase alpha characters, but exclude Q

如果字符串中的第一个字符是脱字符 (^)，则表示允许使用除脱字符后的字符外的所有字符。例如：

ta1.restrict = "^a-z"; // All characters, but exclude lowercase alpha

可以使用反斜线字符来转义特殊字符。例如，要限制使用脱字符：

ta1.restrict = "^\^"; // All characters, but exclude the caret

您可以使用 \u 来输入 ASCII 键码；例如：

ta1.restrict = "\u0020-\u007E"; // ASCII chars 32 through 126 only