Cocos 属性装饰器 property

1.写法参考

// 只有 type 属性时
@property(Node)
targetNode: Node | null = null;

// 一般写法
@property({
    type: Node,
    visible: true,
})
targetNode: Node | null = null;

2.相关参数

参数名	说明	类型	默认值	备注
type	限定属性的数据类型	(Any)	undefined	-
visible	在属性检查器面板中显示或隐藏	boolean	-	-
displayName	在属性检查器面板中显示为另一个名字	string	undefined	-
tooltip	在属性检查器面板中添加属性的 Tooltip	string	undefined	-
multiline	在属性检查器面板中使用多行文本框	boolean	false	-
readonly	在属性检查器面板中只读	boolean	false	-
min	限定数值在编辑器中输入的最小值	number	undefined	-
max	限定数值在编辑器中输入的最大值	number	undefined	-
step	指定数值在编辑器中调节的步长	number	undefined	-
range	一次性设置 min、max、step	[min, max, step]	undefined	step 值可选
slide	在属性检查器面板中显示为滑动条	boolean	false	-

visible 参数:
在没声明 visible 参数情况下，属性是否显示在属性检查器中取决于属性名是否以 _(下划线) 开头。如果是以 _ 开头，则不显示。

3.快速声明

装饰器	对应的 property 写法
@type(t)	@property(t)
@integer	@property(CCInteger)
@float	@property(CCFloat)

4.一些特殊属性的声明

1. 枚举属性

enum ColorEnum{
    Red,
    Bule,
    Green,
    Orange,
}

@property({type: Enum(ColorEnum)})
color = ColorEnum.Red;

2. 数组

@property([Node])
children: Node[] = [];

@property([CCString])
strArr: string[] = [];

• CCInteger 声明类型为 整数
• CCFloat 声明类型为 浮点数
• CCString 声明类型为 字符串
• CCBoolean 声明类型为 布尔值