扩展主菜单

    在样例中,我们通过配置菜单路径,在主菜单 “Example” > “Foobar” 里加入了 “Foo” 和 “Bar” 两个菜单选项。当我们点击这个菜单项,他会发送定义在其 message 字段中的 IPC 消息到主进程中。比如我们点击 “Foo” 将会发送 my-package:foo 这个消息。

    在主菜单中注册中,其键值(Key)需要是一份菜单路径。菜单路径是 posix 路径格式,使用 / 作为分割符。在主菜单注册过程中,Cocos Creator 会根据路径一级一级往下寻找子菜单项,如果在寻找路径中没有找到对应的子菜单,就会在对应的路径中进行创建,直到最后一级菜单,将被当做菜单项加入。

    在注册过程中也会遇到一些出错的情况:

    注册菜单项的父级菜单已经被其他菜单项注册,其类型不是一个子菜单(submenu)

    这个情况和上一种情况类似,我们可以用以下这个例子来说明:

    1. {
    2. "main-menu": {
    3. "message": "my-package:foo"
    4. "Examples/FooBar/Bar": {
    5. "message": "my-package:bar"
    6. }
    7. }

    在这个例子中,我们先在主菜单中注册了一份菜单路径 “Examples/Foobar”,这之后我们有注册了 “Examples/Foobar/Bar”,而第二个菜单路径的注册要求 Foobar 的类型为一个分级子菜单(submenu),然而由于上一次的注册已经将 Foobar 的类型定义为菜单选项(menu-item),从而导致了注册失败。

    在上面的例子中,我们已经使用了 message 菜单选项。菜单注册过程中还有许多其他的可选项,例如:icon、accelerator、type 等。更多选项,请阅读。

    插件专用的菜单分类路径是 i18n:MAIN_MENU.package,在中文语言环境会显示为一级菜单 插件,接下来的二级菜单路径名应该是插件的包名,最后的三级路径是具体的菜单项功能,如:

    i18n:MAIN_MENU.package/FooBar/Bar

    在中文环境的编辑器下就会显示如 插件/FooBar/Bar 这样的菜单。