Flex 3 metadata tags 標簽 - Just Code - JavaEye...

Flex 3 metadata tags

Flex引入了元數據標簽的概念，它告訴編譯器如何編譯這段Flex 或actionscript代碼。大多數人都使用過[Bindable]標簽，元數據標簽是一種特殊的標簽，它在代碼中的作用就是向編譯器提供如何編譯程序的信息。實際上，這些標簽并沒有被編譯到生成的SWF文件中，而只是告訴編譯器如何生成SWF 文件。 這篇Post結合網上相關的資料 以及Adobe的help resource center的相關材料 介紹了16個元數據標簽。

[ArrayElementType]

實際上，定義一個數組通常來說是一件很平常的事情，因為數組中的元素可以是任何類型的。不過，使用

ArrayElementType元數據標簽可以讓你定義數組元素的數據類型。下面的例子展示了如何使用[ArrayElementType]：

[ArrayElementType(”String”)]
public var arrayOfStrings:Array; [ArrayElementType(”Number”)]
public var arrayOfNumbers:Array;

[ArrayElementType(”mx.core.UIComponent”)]
public var arrayOfUIComponents:Array;

[Bindable]

Bindable元數據標簽是最經常用到的一個元數據標簽，因為它使程序組件之間的數據同步變得很容易。Bindable可以用來綁定簡單數據類型、類、復雜數據類型以及函數。綁定數據的時候，你必須先使用元數據標簽定義一下數據。Bindable也可以用來綁定到事件。

[DefaultProperty]

DefaultProperty元數據標簽用來將一個單一屬性設定為某個類的默認屬性。它允許在一個容器標簽內設定屬性，而不用定義屬性的名字。一個簡單的例子就是一個自定義Button類。Listing 3 展示了一個簡單的Button類，它將label屬性設定為了DefaultProperty。Listing 4 展示了label屬性是如何在自定義Button標簽中作為一個字符串定義的。

[Deprecated]

A class or class elements marked as deprecated is one which is considered obsolete, and whose use is discouraged in the current release. While the class or class element still works, its use can generate compiler warnings.

[Embed]

Embed元數據標簽用來導入圖片到程序。可以通過兩種方式使用Embed。你可以將圖片嵌入到ActionScript中并將其指派給一個變量（如同下面代碼中的第一個例子），或者你也可以將圖片直接指派給組件的屬性（使用下面代碼中的第二個例子所示的語法規則）。

例1：

[Embed(source=”myIcon.gif”)]
[Bindable]
public var myIcon:Class;<mx:Button label=”Icon Button 1″ icon=”{myIcon}”/>
<mx:Button label=”Icon Button 2″ icon=”{myIcon}”/>

例2：

<mx:Button label=”Icon Button 1″ icon=”@Embed(source=myIcon.gif’)”/><mx:Button label=”Icon Button 2″ icon=”@Embed(source=myIcon.gif’)”/>

上面這兩個例子產生的結果是一樣的。創建myIcon類的好處是，它在一個類中只定義一次并可以綁定到程序中的多個組件。

[Event]

Event元數據標簽用來聲明那些被自定義類分派的事件。將這個元數據標簽添加到類定義中之后，你就可以在MXML標簽中添加事件處理函數來初始化該自定義類。

[Effect]

Effect元數據標簽用來定義一個自定義效果，當某個事件發生的時候該效果會被分派。

[IconFile]

IconFile 是用來定義一個jpg，gif或者png文件的文件名的，它在你的自定義類中作為圖標來使用。[Embed]元數據標簽可以用來嵌入圖片、SWF文件、音樂文件以及視頻文件等，而IconFile則只是用來嵌入用來作為自定義類圖標的文件。下面是一個IconFile的例子：

[IconFile(”icon.png”)]
public class CustomButton extends Button
{}

[Inspectable]

在使用Flex Builder 2的時候，你可能會希望某些自定義組件的屬性在代碼提示和屬性檢查器（property inspector）中顯示，Inspectable元數據標簽就是用來定義那些屬性的。

[InstanceType]

當在一個模板對象中聲明一個像IDeferredInstance這樣的變量時，InstanceType元數據標簽就用來聲明對象的類型。下面是InstanceType的用法：

[InstanceType(”package.className”)]

[NonCommittingChangeEvent]

NonCommittingChangeEvent元數據標簽在某個特定事件發生的時候可以防止變量在事件發生的過程中被更改。

[RemoteClass]

RemoteClass 可以用來將一個ActionScript類綁定到一個Java類或一個ColdFusion CFC。這樣做可以自動轉換數據類型。下面的例子將包com.mydomain中的名為MyClass的ActionScript類綁定到了同一個包中名為MyClass的Java類：

package com.mydomain {
[Bindable]
[RemoteClass(alias=”com.mydomain.MyClass”)]
public class MyClass {
public var id:int; public var myText:String;

}
}

[Style]

Style元數據標簽用來為組件定義自定義樣式屬性的。只需要簡單地將Sytle元數據標簽添加到類的定義當然，然后就可以使用getSytle方法獲取它的值了。