菜单项

在程序菜单或上下文菜单中插入新的菜单项

进程: 主进程

您可以在 Menu末尾查看示例.

new MenuItem(options)

  • options Object

    • click Function (可选) - 单击菜单项被调用 click(menuItem,browserWindow)

      • menuItem MenuItem

      • browserWindow BrowserWindow

      • event Event

    • role String (可选) - 定义菜单项操作,指定为 click 属性时该项将会被忽略. 详见任务章节.

    • type String (可选) - 可选normal, separator, submenu, checkbox 或 radio.

    • label String - (可选)

    • sublabel String - (可选)

    • accelerator Accelerator (可选)

    • icon (NativeImage | String) (可选)

    • enabled Boolean (可选) - false表示菜单项显示为不可点击的灰色

    • visible Boolean (可选) - false表示菜单项完全隐藏。

    • checked Boolean (可选) - 仅 checkbox或 radio类型菜单项才需要指定。

    • submenu (MenuItemConstructorOptions[] | Menu) (可选) - 应为 submenu 类型菜单项而指定,如果指定了 submenu， 则 type：'submenu'可以省略。如果它的值不是 Menu,将自动转为 Menu.buildFromTemplate。

    • id String - 菜单的唯一id。如果id已被使用,它将被用作这个菜单项的参考位置 position 属性。

    • position String - 定义菜单的具体位置信息。

Roles任务

roles 可使菜单项具有预定义行为.

在创建菜单项时,如果有匹配的方法,建议直接指定 role 属性而不是尝试在 click函数中手动实现该行为,这样可以给用户最好的使用体验。

当使用 role时, label和 accelerator 的值是可选的,默认将根据平台使用适当的值。

role属性值可以为:

  • undo

  • redo

  • cut

  • copy

  • paste

  • pasteandmatchstyle

  • selectall

  • delete

  • minimize - 最小化当前窗口

  • close - 关闭当前窗口

  • quit- 退出应用

  • reload -重新加载当前窗口

  • forcereload - 重新加载当前窗口并忽略缓存。

  • toggledevtools - 在当前窗口中切换开发人员工具

  • togglefullscreen - 在当前窗口切换全屏模式

  • resetzoom - 聚焦页缩放级别重置为原始大小

  • zoomin - 聚焦页放大10％

  • zoomout - 聚焦页缩小10％

  • editMenu - 默认的 编辑菜单 (撤销, 复制等等)

  • windowMenu - 默认的 窗口菜单 (最小化, 关闭等等)

在 macOS 上也可使用下列 role :

  • about - 映射到 orderFrontStandardAboutPanel动作

  • hide - 映射到 hide动作

  • hideothers - 映射到 hideOtherApplications动作

  • unhide - 映射到 unhideAllApplications动作

  • startspeaking - 映射到 startSpeaking动作

  • stoppeaking - 映射到 stopSpeaking动作

  • front - 映射到 arrangeInFront动作

  • zoom - 映射到 performZoom动作

  • window - 子菜单是一个 Window菜单

  • help - 子菜单是一个 帮助菜单

  • services - 子菜单是一个 服务菜单

当在macOS上指定 role时, label 和 accelerator是唯一会影响MenuItem的选项。其他选项将被忽略。

实例属性

menuItem.enabled

属性:是否启用该项

此属性可以动态更改。

menuItem.visible

属性:是否可见该项

此属性可以动态更改。

menuItem.checked

属性:该项是否已选中

checkbox 菜单项将在选中时打开或关闭 checked属性 radio菜单项将在点击时打开其checked属性,并将关闭同一菜单中所有相邻项的该属性。

如果需要其他行为,您可以直接添加一个 click函数。

此属性可以动态更改。

menuItem.label

属性:菜单项内容字符串

menuItem.click

属性:点击菜单项时需要触发的函数

Previous菜单Next系统托盘

Last updated