CocosCreator之property序列化用法介绍

最新推荐文章于 2026-03-25 01:06:00 发布

原创最新推荐文章于 2026-03-25 01:06:00 发布 · 1.1w 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#cocosCreator property #cocosCreator 序列化 #序列化

CocosCreator 专栏收录该内容

10 篇文章

订阅专栏

本文档介绍了CocosCreator中property的序列化用法，包括multiline、type、visible等属性的意义，以及如何序列化枚举、数组、CC.RawAsset和滑动条。通过示例代码展示简便的序列化操作，并提供了官方文档链接以供深入学习。

1：官方代码

export function property(options?: {type?: any; url?: typeof cc.RawAsset; visible?: boolean|(() => boolean); displayName?: string; tooltip?: string; multiline?: boolean; readonly?: boolean; min?: number; max?: number; step?: number; range?: number[]; slide?: boolean; serializable?: boolean; formerlySerializedAs?: string; editorOnly?: boolean; override?: boolean; animatable?: boolean} | any[]|Function|cc.ValueType|number|string|boolean): Function;
export function property(_target: Object, _key: any, _desc?: any): void;

2：设置意义
multiline：换行
type：类型
visible：是否显示
url ：cc.RawAsset资源类型
displayName: 面板显示的名字
tooltip :未知
multiline: 是否换行
readonly: 是否只读(锁定)
Function:方法

3:示例：
序列化枚举：

enum Arrangement //排序枚举
{
    Horizontal = 1, //横排
    Vertical = 2, //竖排
}
@property({type :cc.Enum(Arrangement),displayName:"排序枚举"})
private arrangement:Arrangement = Arrangement.Horizontal;

序列化数组：

@property({type:[cc.AudioClip]})
audioClips:cc.AudioClip[] = [];

序列化CC.RawAsset

@property({url:cc.Texture2D})
texture:cc.Texture2D = null;
或者
@property(cc.Texture2D)
texture:cc.Texture2D = null;

序列化滑动条

 @property({range:[1,200],slide:true})//min:0,max:100,
 nun:number= 0;
 min,max会对 number数值进行限制

一般我们通常都是使用简便的用法如

@property(cc.SpriteAtlas)
spriteAtlas:cc.SpriteAtlas = null;
@property(cc.Node)
item:cc.Node = null;

官方文档：http://docs.cocos.com/creator/manual/zh/scripting/reference/attributes.html
之前找官方的文档找了蛮久都没找到，突然就翻到了这个文档，介绍非常详细