FormItem 容器在 Spark From 中定义以下内容:
- 单个标签。
- 序列标签。
- 一个或多个子控件或子容器。
- 提供介绍表单项及其填写说明的帮助内容。
- 指示表单项是否需要填写的指示符
子容器可以是控件,也可以是其他容器。一个 Form 容器可以容纳多个 FormItem 容器。默认情况下,FormItem 元素按水平布局排列,标签放置在左侧,帮助内容显示在右侧。
隐藏 MXML 语法
The <s:FormItem> tag inherits all the tag
attributes of its superclass and adds no new tag attributes:
<s:FormItem
Properties
helpContent="null"
label=""
required="false"
sequenceLabel=""
Common Styles
errorIndicatorSource="assets/ErrorIndicator.png"
requiredIndicatorSource="assets/RequiredIndicator.png"
Mobile Styles
leading="2"
letterSpacing="0"
/>
mxmlContentFactory
查看示例
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
elementErrorStrings:Vector.<String> [只读]
每个矢量项都包含来自内容元素的错误字符串。如果内容元素都有效,则矢量为空。
此属性可用作数据绑定的源。修改此属性后,将调度 propertyChange 事件。
public function get elementErrorStrings():Vector.<String>
helpContent:Array
要包含在 FormItem 的帮助内容区域中的组件集。
默认值为 null。
此属性可用作数据绑定的源。修改此属性后,将调度 helpContentChanged 事件。
public function get helpContent():Array public function set helpContent(value:Array):void
label:String
FormItem 文本标签。例如,用于输入地址的 FormItem 可能具有“Address”标签。
默认值为 ""。
此属性可用作数据绑定的源。修改此属性后,将调度 labelChanged 事件。
public function get label():String public function set label(value:String):void
required:Boolean
如果为 true,则将 FormItem 外观置于 required 状态。默认情况下,该状态将显示一个指示符以指示 FormItem 子项要求用户进行输入。如果为 false,则不会显示指示符。
此属性仅控制外观的状态。如果您需要输入验证,必须将验证程序指定给子项。
默认值为 false。
此属性可用作数据绑定的源。修改此属性后,将调度 requiredChanged 事件。
public function get required():Boolean public function set required(value:Boolean):void
sequenceLabel:String
表单中表单项的数目。
默认值为 ""。
此属性可用作数据绑定的源。修改此属性后,将调度 sequenceLabelChanged 事件。
public function get sequenceLabel():String public function set sequenceLabel(value:String):void
public function FormItem()
构造函数。
protected function updateErrorTextDisplay():void
将 elementErrorStrings 转换为 String,并将该 String 指定给 errorTextDisplay 外观部件进行显示。
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Spark FormItem control layout -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx">
<s:Panel title="Spark FormItem Control layout Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:Scroller width="100%" height="100%">
<s:Group left="10" right="10" top="10" bottom="10">
<s:Form id="frm" defaultButton="{sbmt}">
<s:FormHeading label="STACKED SPARK FORM" backgroundColor="haloSilver" />
<s:FormItem sequenceLabel="i)" label="First/last name:" required="true">
<s:TextInput id="fName" maxChars="64" />
<s:TextInput id="lName" maxChars="64" />
</s:FormItem>
<s:FormItem sequenceLabel="ii)" label="Address:">
<s:layout>
<s:HorizontalLayout />
</s:layout>
<s:TextInput id="address1" maxChars="128" />
<s:TextInput id="address2" maxChars="128" />
</s:FormItem>
<s:FormItem>
<s:Button id="sbmt" label="Submit" />
</s:FormItem>
</s:Form>
</s:Group>
</s:Scroller>
</s:Panel>
</s:Application>
显示 MXML 语法








