Flex中的元标签及使用

元数据标签是一种特殊的标签,它在代码中的作用就是向编译器提供如何编译程序的信息。
实际上,这些标签并没有被编译到生成的SWF文件中,而只是告诉编译器如何生成SWF 文件。

Flex中的元标签列表如下:

标签 描述
[ArrayElementType("elementType")] 在数组中定义所有允许的数据类型。
[Bindable]
[Bindable(event="eventname")]
声明一个属性可以在代码中使用数据绑定表达式,Bindable可以用来绑定简单数据类型、类、复杂数据类型以及函数。
[DefaultProperty("propertyName")] 定义组件在MXML中使用时的默认属性的名称。
[Deprecated] 标识一个类或类的元素是不推荐使用的,这样编译器能认出他并在被调用时给出一个警告信息。
[Effect] 定义MXML的特效属性名称。
[Embed] 在编译时导入 JPED,PNG,SVG 或 SWF文件。也会导入SWC文件的图片资源。他的功能等同于MXML中的 @Embed 语法。
[Event] 定义MXML的事件属性的名称和类型。
[Exclude] 使 Flex Builder 的标签检查器忽略类元素。语法类似 [Exclude(name="label", kind="property")]
[ExcludeClass] 是 Flex Builder 标签检查器忽略类。这相当于ASDoc中的 @private 标签。
[IconFile] 定义一个图标文件,使组件在Adobe Flex Builder的插入面板中以该图标显示。
[Inspectable] 定义一个属性的列表,供组件使用者在 Flex Builder 的的属性提示和标签检查中使用。同时也定义了属性的可用值。
[InstanceType] 指定了 IDeferredInstance 中的,属性接受的数据类型。
[NonCommittingChangeEvent] 定义一个事件过渡触发器。
[RemoteClass] 把一个ActionScript对象映射到Java对象。
[Style] 为组件的样式属性定义一个MXML标签属性。
[Transient] 当一个 ActionScript 对象被映射到Java对象后,被该标签标识的属性,会从发送到服务端的数据中忽略掉。

[ArrayElementType]

使用ArrayElementType元数据标签可以让你定义数组元素的数据类型。

[ArrayElementType("Number")]
public var arr:Array;

事实上,MXML编译器只针对mxml代码中的ArrayElementType元数据标签的用法进行合理性检查。而对 actionscript代码中的用法不进行合理性检查,通过试验可以知道,ArrayElementType标签此时是无效的。

也就是说,上面的声明是无效的~,只有在MXML里才能正确检查,你可以测试一下:

arr.push(1);
arr.push("name"); //并不会报错

Bindable绑定数据的例子

申明变量txt可绑定后,当txt值改变,绑定txt的Label显示的内容也会跟着改变。

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
layout="absolute" creationComplete="init()">
<mx:Script>
<![CDATA[
[Bindable]
private var txt:String = "Hello world.";

private function init():void
{
changeBtn.addEventListener(MouseEvent.CLICK,
function():void{txt="Hello World,Hello World."});
}
]]>
</mx:Script>
<mx:Label x="10" y="10" text="{txt}"/>
<mx:Button x="10" y="36" label="更新数据" id="changeBtn"/>
</mx:Application>

[DefaultProperty("propertyName")]

DefaultProperty元数据标签用来将一个单一属性设定为某个类的默认属性。它允许在一个容器标签内设定属性,而不用定义属性的名字。

package myComponents
{
import mx.controls.TextArea;

// 定义一个默认的属性defaultText,下例中的Hello将做为defaultText的值。
[DefaultProperty("defaultText")]

public class TextAreaDefaultProp extends TextArea {

public function TextAreaDefaultProp()
{
super();
}

// Define a setter method to set the text property
// to the value of the default property.
public function set defaultText(value:String):void {
if (value!=null)
text=value;
}

public function get defaultText():String {
return text;
}
}
}

在MXML里使用该组件:

<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
xmlns:MyComp="myComponents.*">
<MyComp:TextAreaDefaultProp>Hello</MyComp:TextAreaDefaultProp>
</mx:Application>


posted on 2010-08-26 19:03  SageChen  阅读(1241)  评论(0编辑  收藏  举报

导航