Attribute reference
The attribute is used to append metadata to a defined property, similar to the Decorator of the scripting language or the Attribute of C#.
Properties panel corresponding attributes
Parameter name | Explanation | Type | Default | Remarks |
---|---|---|---|---|
type | restrict the data type for property | (Any) | undefined | See type attribute |
visible | show or hide in the Properties | boolean | (note 1) | See visible attribute |
displayName | show another name in the Properties | string | undefined | |
tooltip | add Tooltip for property in the Properties | string | undefined | |
multiline | use multiple lined text box in the Properties | boolean | false | |
readonly | read-only in the Properties | boolean | false | |
min | restrict the minimum value in Properties | number | undefined | |
max | restrict the maximum value in Properties | number | undefined | |
step | restrict the step value in Properties | number | undefined | |
range | one-time setup for min, max, step | [min, max, step] | undefined | step is optional |
slide | show a slider in the Properties | boolean | false |
Serialization associated attributes
These attributes cannot be used for the get method.
Parameter name | Explanation | Type | Default | Remarks |
---|---|---|---|---|
serializable | serialize this property | boolean | true | See serializable attribute |
formerlySerializedAs | specify the name of the field used in formerly serialization | string | undefined | Use this attribute to rename a property without losing its serialized value. |
editorOnly | reject this property before exporting the project | boolean | false |
Other attributes
Parameter name | Explanation | Type | Default | Remark |
---|---|---|---|---|
default | define default for the property | (Any) | undefined | See default attribute |
notify | trigger a specific method when assigning the property | function (oldValue) {} |
undefined | The default property is needed to define and is not available for array. Not support ES6 Classes. |
override | when reloading the super class property, this parameter needs to be defined as true | boolean | false | See override attribute |
animatable | whether this property can be altered by the Timeline editor | boolean | undefined | |
url(legacy) | this property is the URL of an assigned asset | function (constructor inherited from cc.RawAsset) |
undefined | See Acquire and load asset: Raw Asset (deprecated, use type instead please) |
Note 1: the default value of
visible
is determined by the property name. When the property name starts with an underscore_
, then the default is set to hide, otherwise it is by default set to show.