CCClass 中属性 property 属性参数
-
type限定属性的数据类型@property({ type: cc.Node }) test: cc.Node = null; //or @property(cc.Node) test: cc.Node = null; //数组 @property({ type: cc.Node }) private test: cc.Node[] = []; //or @property([cc.Node]) private test: cc.Node[] = []; //如果将 type 设置为枚举，则在属性编辑器中会显示一个下拉框 enum TestEnum { Value1 = 0, Value2 = 1 } ... @property({ type: cc.Enum(TestEnum) }) private test: TestEnum = TestEnum.Value1;
//可以通过使用 cc.Component.EventHandler 类型，添加一个和Button一样的事件回调
@property(cc.Component.EventHandler)
private callback: cc.Component.EventHandler = null;
property13.png
-
visible在 属性性检查器 中显示或隐藏isShow: boolean = false; @property({ type: cc.Node, visible() { return this.isShow; } }) test: cc.Node = null;
-
displayName在 属性检查器 中显示为另一个名字@property({ type: cc.Node, displayName: "节点" }) test: cc.Node = null;
-
tooltip在 属性检查器 中添加属性的 Tooltip，将鼠标悬浮于属性上会出现对应的字符串@property({ type: cc.Node, tooltip: "这是一个节点" }) test: cc.Node = null;
-
multiline在 属性检查器 中使用多行文本框@property({ multiline: true }) private string: string = "";
-
readonly在 属性检查器 中只读@property({ readonly: true }) private string: string = "over";
-
min限定数值在编辑器中输入的最小值@property({ min: 0 }) private index: number = 0;
-
max限定数值在编辑器中输入的最大值@property({ max: 1 }) private index: number = 0;
-
step指定数值在编辑器中调节的步长@property({ step: 1 }) private index: number = 0;
-
range一次性设置min,max,step@property({ range: [0, 1, 1] }) private index: number = 0; -
slide在 属性检查器 中显示为滑动条，需要设置max及min，step无效@property({ slide: true, min: 0, max: 10, step: 1 }) private index: number = 0;
-
serializable序列化该属性，指定了default默认值的属性默认情况下都会被序列化，序列化后就会将编辑器中设置好的值保存到场景等资源文件中，并且在加载场景时自动还原之前设置好的值@property({ serializable: true }) private index: number = 0; -
formerlySerializedAs指定之前序列化所用的字段名，重命名属性时，声明这个参数来兼容之前序列化的数据 -
editorOnly在导出项目前剔除该属性 -
default定义属性的默认值//ts @property({type: cc.Node}) private test: cc.Node = null; //js test: { default: null, type: cc.Node } -
notify当属性被赋值时触发指定方法，用法同visible需要定义default属性并且不能用于数组，也不支持ES6定义方式 -
override当重写父类属性时需要定义该参数为 true -
animatable该属性是否能被 动画编辑器 修改，设置为true后该属性可以在动画编辑器中添加动画 - 定义
get/set方法，设置get后，属性无法被序列化，也无法设置默认值//ts private _color: cc.Color = cc.Color.WHITE; @property({ type: cc.Color }) get color() { return this._color; } set color(color: cc.Color) { this._color = color; } //js color: { default: cc.Color.WHITE, type: cc.Color get: function () { return this._color; }, set: function (value) { this._color = value; } },
