Metadata标签 一 概述

 

MXML和ActionScript文件插入元数据标签到Adobe ®的Flex ®编译器提供的信息。元数据标签不被编译成可执行代码，但提供的信息来控制你的代码的某些部分如何编译。欲了解更多有关额外的元数据标签的信息，您在创建应用程序，如[Embed]元数据标签时使用，

关于元数据标签

元数据标签来描述你的组件是如何在应用中使用的编译器，提供信息。例如，您可能会创建一个组件，它定义一个新的事件。为了使Flex编译器，这样你可以在MXML中引用该事件，插入[事件]到组件的元数据标签，如下面的ActionScript类定义显示：

[Event(name="enableChanged", type="flash.events.Event")]
class ModalText extends TextArea {
...
}

在这个例子中，[Event]元数据标签指定事件的名称和类，它定义事件调度的事件对象的类型。在确定事件的编译器，你可以在MXML中引用它，如下面的示例所示：

<?xml version="1.0"?>
<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" xmlns:MyComp="*">
                          <fx:Script>
                                        <![CDATA[
                                                   function handleEnableChangeEvent(eventObj:Event):void {
                                                   ...
                                                   }
                                        ]]>
                          </fx:Script>
            <MyComp:ModalText enableChanged="handleEnableChangeEvent(event);"/>
</s:Application>

 

如果省略[Event]从你的类定义时，Flex问题语法错误时，编译MXML文件的元数据标签。此错误信息表明，Flex不会承认enableChanged属性。

Flex编译器认识到，在您的ActionScript类文件和MXML文件组件的元数据报表。元数据标签定义组件的属性，数据绑定属性，事件，和其他组件的性能。 Flex的解释这些语句在编译过程中，他们从来没有在运行时解释。

元数据报表相关的类的声明，个人数据领域，或方法。他们必然要在文件中的下一行。当你定义一个组件的属性或方法，添加元数据标记前行的属性或方法声明。

Metadata tags in ActionScript：

在ActionScript文件，当你定义组件事件或其他方面的一个组件，它影响到一个单一的财产多，您可以添加类定义之外的元数据标签，使元数据绑定到整个类，如下面的示例显示：

// Add the [Event] metadata tag outside of the class file.
[Event(name="enableChange", type="flash.events.Event")]
public class ModalText extends TextArea {
...
// Define class properties/methods
private var _enableTA:Boolean;
// Add the [Inspectable] metadata tag before the individual property.
[Inspectable(defaultValue="false")]
public function set enableTA(val:Boolean):void {
_enableTA = val;
this.enabled = val;
// Define event object, initialize it, then dispatch it.
var eventObj:Event = new Event("enableChange");
dispatchEvent(eventObj);
}
}

 

在这个例子中，类的定义前添加元数据标签的[Event]表明，类分派事件命名enableChanged。您还包括[ Inspectable ]元数据标签标明为Adobe ®闪存®生成器™属性的默认值。使用这个标签的详细信息，请参见Inspectable元数据标签”。

 

Metadata tags in MXML:

在MXML文件中，可以插入元数据标签在<fx:Script>块沿与您的ActionScript代码，或在<fx:Metadata>块，如下面的例子显示：

<?xml version="1.0"?>
<!-- TextAreaEnabled.mxml -->
<mx:TextArea xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Metadata>
[Event(name="enableChange", type="flash.events.Event")]
</fx:Metadata>
<fx:Script>
<![CDATA[
// Import Event class.
import flash.events.Event;
// Define class properties and methods.
private var _enableTA:Boolean;
// Add the [Inspectable] metadata tag before the individual property.
[Inspectable(defaultValue="false")]
public function set enableTA(val:Boolean):void {
_enableTA = val;
this.enabled = val;
// Define event object, initialize it, then dispatch it.
var eventObj:Event = new Event("enableChange");
dispatchEvent(eventObj);
}
]]>
</fx:Script>
</mx:TextArea>

之间的一个关键的区别<fx:Metadata>和<fx:Script>标签内的文本<fx:Metadata>标记生成的类声明之前插入，但文本内<fx:Script>标签插在体内生成的类声明。因此，元数据标签，喜欢[Event事件]和[Effect]必须在<fx:Metadata>标记，但可[Bindable]和[Embed]元数据标签必须在<fx:Script>标签。

Metadata tags:

下面表描述的元数据标签，您可以使用ActionScript类文件：

[Alternative] ------指定更换现有的类的类，和一个版本号，表示发生更换时。

[ArrayElementType]-------允许的数据类型定义的数组中的每个元素。

[Bindable]------标识的属性，您可以使用数据绑定表达式的源。

[DefaultProperty]-------当您使用的组件在MXML文件中定义组件的默认属性的名称。

[Deprecated]------标记为废弃，使编译器可以识别它，并发出警告的元素时，是在应用中使用的类或类的元素。

[Effect]------定义效果的MXML属性的名称。

[Embed]------Imports  JPEG，GIF，PNG，SVG和SWF文件在编译时。还是从SWC文件中导入图像附件。这是功能上等同于MXML中                                @Embed;

[Event]------定义事件和组件发出的事件对象的数据类型的MXML属性。

[Exclude]------省略一个继承类的元素，从Flash Builder标签检查。语法如下：

                      [Exclude(name="label", kind="property")]  

                    其中一种属性，方法，事件，或样式。

[ExcludeClass]------省略了从Flash Builder标签检查的类。这是等价的ASDoc中的@ private标签时，适用于一类。

[HostComponent]------指定为Spark皮肤类的主机组件的“HostComponent元数据标签”。

[IconFile]------标识为组件的Adobe Flash Builder中插入“栏的图标，表示文件名。

[Inspectable]------定义暴露在Flash Builder的属性提示和标签检查器组件用户属性。也限制了允许值的属性。

[InstanceType]------指定允许的数据类型，一个类型IDeferredInstance的属性。

[NonCommittingChangeEvent]------标识作为一项临时触发的事件。

[RemoteClass]------ActionScript对象映射到Java对象。

[RichTextContent]------指出Mxml中的某个属性的值总是会被编译器解释为String。

[SkinPart]------定义皮肤组件的一个b部分。

[SkinState]------定义一个皮肤组件支持的视图状态 。

[Style]------为组件的MXML属性定义一个样式属性。

[SWF]------指定应用程序的属性，当你写在ActionScript中的主应用程序文件。

[Transient]------标识是发送到服务器的数据应该从省略，当一个ActionScript对象映射到Java对象，使用[RemoteClass]属性。