Electron中文手册
  • 文档概述
  • 开发指南目录
  • 构建说明(Linux)
  • 构建说明(macOS)
  • 构建说明(Windows)
  • 构建系统概述
  • 编码规范
  • 在 macOS 中调试
  • 在 Windows 中调试
  • 在C ++代码中使用clang-format
  • 在调试器中设置符号服务器
  • 源代码目录结构
  • Chrome升级清单
  • Chromium 开发指南
  • V8 开发指南
  • 教程目录
    • 关于 Electron
    • Electron 版本说明
    • API弃用说明
    • 快速入门
    • 支持的平台
    • 桌面环境集成
    • 系统通知
    • 离屏渲染
    • 在线/离线事件检测
    • 多线程
    • REPL
    • 键盘快捷键
    • DevTools扩展
    • 使用原生模块
    • 使用 Pepper Flash 插件
    • 使用 Selenium 和 WebDriver
    • 使用 Widevine CDM 插件
    • 应用分发
    • 应用打包
    • 主进程调试
    • 使用 node-inspector 进行主进程调试
    • 使用 VSCode 进行主进程调试
    • Mac App Store应用提交指南
    • Windows App Store应用提交指南
    • 安全,本地功能和你的责任
    • Headless CI Systems 测试
  • API接口目录
    • API接口之公用接口
      • 应用语言
      • 开发概要
      • 专业术语
      • 常见问题
      • 环境变量
      • 快捷键字符串
      • 命令行
      • 客户端请求
      • 剪贴板
      • <File> H5 File文件操作
      • 无框窗口
      • <window.open> window.open打开新窗口或打开时传递消息
      • 沙盒选项
    • API接口之主进程接口
      • 整体控制
      • 全局快捷键
      • 图标创建与应用
      • 屏幕
      • 窗口
      • 菜单
      • 菜单项
      • 系统托盘
      • 网页内容
      • 从主进程到渲染进程的异步通信
      • 对话框
      • 创建和控制视图
      • 会话
      • 会话,缓存和代理等控制
      • 页面请求
      • HTTP/HTTPS请求处理
      • 协议的注册和处理
      • 使用系统默认应用程序管理文件或URL
      • 下载项管理
      • 进程控制
      • Chromium原生网络库
      • 获取系统首选项
      • 电源状态
      • 节能管理
      • 调试工具
      • 奔溃报告
      • 性能数据收集
      • 自动更新
      • TouchBar触摸条
      • TouchBar触摸条按钮
      • TouchBar触摸条拾色器
      • TouchBar触摸条分组
      • TouchBar触摸条scrubber
      • TouchBar触摸条分段控件
      • TouchBar触摸条label标签
      • TouchBar触摸条弹出框
      • TouchBar触摸条滑块
      • TouchBar触摸条间隔符
    • API接口之渲染进程接口
      • 页面渲染
      • <webview> webview标签
      • 渲染进程与主进程通信
      • 从渲染进程到主进程的异步通信
      • 子窗口
      • 捕获桌面资源
  • 结构列表
    • 蓝牙设备对象
    • 证书对象
    • 证书主体对象
    • Cookie对象
    • 崩溃报告对象
    • 桌面捕获源对象
    • 显示器对象
    • 打印机信息对象
    • 文件过滤器对象
    • 最近使用的项目
    • 常用列表项
    • CPU使用率对象即程序占用的CPU资源
    • IO值对象
    • 内存信息对象
    • 进程内存信息对象
    • 内存使用详细信息
    • Mime类型缓冲区
    • 矩形对象
    • 删除客户端证书对象
    • 删除密码对象
    • Scrubber项对象
    • 分段控制对象
    • 快捷方式对象
    • 任务对象
    • 缩略图工具栏按钮对象
    • 上传blob对象
    • 上传数据对象
    • 上传文件系统对象
    • 上传文件对象
    • 上传原始数据对象
Powered by GitBook
On this page
  • new MenuItem(options)
  • Roles任务
  • 实例属性
  • menuItem.enabled
  • menuItem.visible
  • menuItem.checked
  • menuItem.label
  • menuItem.click

Was this helpful?

  1. API接口目录
  2. API接口之主进程接口

菜单项

Previous菜单Next系统托盘

Last updated 4 years ago

Was this helpful?

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

进程:

您可以在 末尾查看示例.

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 (可选)

    • icon ( | 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

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

Menu
Accelerator
NativeImage
任务章节
主进程