自定义偏好设置面板

    点击可打开偏好设置面板,如下图示:

    preferences

    偏好设置面板分成左右两侧:

    • 右侧是根据配置渲染出来的操作面板。

    面板上的修改,会立即修改到对应的配置项目上,更多关于 偏好设置 面板的介绍,请参考文档 偏好设置

    Cocos Creator 允许每个扩展注册自己的编辑器配置,然后在偏好设置面板内显示。

    偏好设置允许以两种方式显示配置:

    1. 通用配置
    2. 实验室配置

    通用设置直接以选项卡的形式展示,而实验室开关则单独一个选项卡集中展示。

    • 当插件提供的功能处于开发阶段时建议将功能的开关配置数据放在实验室配置中。

    自定义偏好设置需要依赖数据配置,需要先在 里定义好相关数据字段。

    当定义好数据字段后,还需要在 contributions.preferences 字段里定义需要显示的数据以及用什么 UI 组件来显示。如下所示:

    上面的示例中,在 contributions.profile.project 字段定义了 4 个数据项: foo、、foo2foo3

    contributions.preferences 字段中,我们定义了 和 laboratory

    properties 中定义的字段,将在偏好设置面板中新建一个与扩展同名的标签页独立显示,如下图所示:

    laboratory 中定义的字段,将在偏好设置面板中的 实验室(Laboratory) 标签页中显示,如下图所示:

    preferences-tool-custom-laboratory

    本示例展示了 4 种常见 UI 组件在自定义偏好设置面板时的用法,理论上所有带 value 属性的 UI 组件都可以用于偏好设置面板,具体用法请参考文档 。