使用组件 |
|
|
|
| 创建组件 > 创建 ActionScript 类文件 > 添加组件元数据 > 关于 Inspectable 标记 | |||
使用 Inspectable 标记可以指定显示在"组件"检查器和"属性"检查器中的用户可编辑(可检查)的参数。这样,您就可以在同一个位置维护可检查属性和基本的 ActionScript 代码。要查看组件属性,请将组件的实例拖到舞台上,然后在"组件"检查器中选择"参数"选项卡。
Collection 参数也是可检查参数。有关详细信息,请参阅关于 Collection 标记。
下图显示了 DateChooser 组件的"组件"检查器中的"参数"选项卡:

或者,您也可以在"属性"检查器的"参数"选项卡中查看组件属性的子集。

Flash 使用 Inspectable 标记确定应在创作环境中显示哪些参数。此标记的语法如下:
[Inspectable(value_type=value[,attribute=value,...])] property_declaration name:type;
下面的示例将 enabled 参数定义为可检查参数:
[Inspectable(defaultValue=true, verbose=1, category="Other")] var enabled:Boolean;
Inspectable 标记也支持宽松类型的属性,如下所示:
[Inspectable("danger", 1, true, maybe)]
元数据声明必须紧挨着属性的变量声明且在它之前,这样才能绑定到该属性。
下表介绍 Inspectable 标记的属性:
|
属性 |
类型 |
说明 |
|---|---|---|
|
|
String 或 Number |
(可选)可检查属性的默认值。 |
|
|
String |
(可选)指定以逗号分隔的属性合法值列表。 |
|
|
Number |
(可选)其作用是向后兼容 Flash MX 组件。它用作 List 值的默认索引。 |
|
|
String |
(可选)属性的显示名称。例如,Font Width。如果未指定,则使用属性的名称,例如 |
|
|
String |
(可选)类型指定。如果省略,则使用属性的类型。下面是可接受的值:
|
|
|
String |
(可选)其作用是向后兼容 Flash MX 组件。指定此参数所绑定的变量。 |
|
|
Number |
(可选)将 verbose 属性设置为 1 的可检查属性,它不显示在"属性"检查器中,但显示在"组件"检查器中。通常用于不经常修改的属性。 |
不需要任何这些属性;可以将 Inspectable 用作元数据标记。
标记为 Inspectable 的所有超类属性在当前类中都是自动可检查的。如果要为当前类隐藏其中某些属性,请使用 InspectableList 标记。
|
|
|
|