-
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;
-
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定义方式，在TS中不可使用，只能用set代替 -
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;
}
}
