自定义主菜单

编辑器顶部有一栏主菜单,在扩展内可以方便的在这个菜单栏添加自己的菜单。

注册菜单

当扩展需要添加菜单的时候,只需要填写 contributions.menu 对象。例如我们在 “扩展” 菜单里增加一个菜单项,可以修改 package.json,代码示例如下:

  1. {
  2. // package.json
  3. "name": "hello-world",
  4. "contributions": {
  5. "messages": {
  6. "open-panel": {
  7. "methods": ["openPanel"]
  8. }
  9. },
  10. "menu": [
  11. {
  12. "path": "i18n:menu.extension",
  13. "label": "Open Hello World",
  14. "icon": "./static/icon.png",
  15. "message": "open-panel"
  16. }
  17. ]
  18. }
  19. }

上面的配置信息将会在编辑器的 “扩展” 菜单里新增一个 “Open Hello World” 菜单,点击这个菜单后将会按照 message 配置发送一条 open-panel 消息给当前扩展,若当前扩展配置了这个消息的监听以及对应的 openPanel 处理函数,将会被触发。

关于消息的定义请参考文档 自定义消息

下面我们来看看 menu 对象中各字段的意义:

path

类型 {string} 必填

填写格式为:[顶部已有菜单路径][/路径1][/路径2],以下写法都是合理的:

  • i18n:menu.extension - 以扩展菜单作为父菜单
  • i18n:menu.extension/Hello World - 在扩展菜单中添加一个 Hello World 菜单项作为父菜单
  • MyMenu - 在顶部菜单栏添加一个 MyMenu 菜单作为父菜单
  • MyMenu/Hello World - 在顶部菜单栏添加一个 MyMenu,并再添加一个 Hello World 菜单项作为父菜单

顶部菜单栏中,预设的菜单有:

  • i18n:menu.project - “项目” 菜单
  • i18n:menu.node - “节点” 菜单
  • i18n:menu.panel - “面板” 菜单
  • i18n:menu.extension - “扩展” 菜单
  • i18n:menu.develop - “开发者” 菜单

label

类型 {string} 必填

菜单项目的名称,支持 i18n:key 语法。

icon

类型 {string} 可选

菜单的图标相对路径,扩展使用的素材一般放在名为 static 的文件夹下面,若不存在则新建一个。

message

类型 {string} 可选

菜单点击后触发的消息,此消息需要在 contributions.messsages 中先定义。