Electron 菜单系统深度解析：从基础到高级实践

斯~内克

已于 2025-03-31 13:48:25 修改

阅读量659

点赞数 16

分类专栏： Electron 文章标签： electron javascript 前端

于 2025-03-29 08:30:00 首次发布

本文链接：https://blog.csdn.net/qq_51757896/article/details/146609094

版权

Electron 专栏收录该内容

5 篇文章

订阅专栏

一、Electron 菜单体系架构

1.1 菜单系统的核心组成

Electron 的菜单系统由三大核心模块构成：

应用菜单（Application Menu）：位于窗口顶部的全局菜单栏（Windows/Linux）或系统菜单栏（macOS）
上下文菜单（Context Menu）：右键触发的上下文相关菜单
托盘菜单（Tray Menu）：系统托盘区的弹出式菜单

1.2 多平台适配差异

特性	Windows	macOS	Linux
菜单栏位置	窗口顶部	系统顶部栏	窗口顶部
快捷键显示	带下划线	右侧显示	带下划线
系统菜单项	无	有（关于/服务等）	无

二、基础菜单开发实践

2.1 应用菜单创建

2.1.1 基础模板语法

const { Menu } = require('electron')

const template = [
  {
    label: '文件',
    submenu: [
      { label: '新建', accelerator: 'CmdOrCtrl+N' },
      { type: 'separator' },
      { label: '退出', role: 'quit' }
    ]
  }
]

const menu = Menu.buildFromTemplate(template)
Menu.setApplicationMenu(menu)

2.1.2 角色（Role）系统

Electron 预定义角色列表：

undo/redo - 撤销/重做
cut/copy/paste - 剪切板操作
reload - 刷新页面
togglefullscreen - 全屏切换

{
  label: '编辑',
  submenu: [
    { role: 'undo' },
    { role: 'redo' },
    { type: 'separator' },
    { role: 'cut' },
    { role: 'copy' },
    { role: 'paste' }
  ]
}

2.2 上下文菜单实现

2.2.1 渲染进程注册

// preload.js
const { contextBridge, ipcRenderer } = require('electron')

contextBridge.exposeInMainWorld('electron', {
  showContextMenu: () => ipcRenderer.send('show-context-menu')
})

// renderer.js
window.addEventListener('contextmenu', (e) => {
  e.preventDefault()
  window.electron.showContextMenu()
})

2.2.2 主进程处理

// main.js
ipcMain.on('show-context-menu', (event) => {
  const menu = Menu.buildFromTemplate([
    { label: '复制', role: 'copy' },
    { type: 'separator' },
    { 
      label: '自定义操作',
      click: () => event.sender.send('custom-action') 
    }
  ])
  
  const win = BrowserWindow.fromWebContents(event.sender)
  menu.popup({ window: win })
})

三、高级菜单开发技巧

3.1 动态菜单系统

3.1.1 运行时更新菜单

function updateMenu(editEnabled) {
  const template = [
    {
      label: '编辑',
      submenu: [
        {
          label: '保存',
          enabled: editEnabled,
          click: () => handleSave()
        }
      ]
    }
  ]
  
  const menu = Menu.buildFromTemplate(template)
  Menu.setApplicationMenu(menu)
}

3.1.2 菜单状态同步

// 主进程
const menu = Menu.buildFromTemplate([...])
menu.items[0].submenu.items[2].enabled = false

// 渲染进程通信
ipcRenderer.on('update-menu-state', (_, state) => {
  const menuItem = Menu.getApplicationMenu().getMenuItemById('save-item')
  menuItem.enabled = state
})

3.2 多窗口菜单管理

3.2.1 窗口专属菜单

function createWindowWithMenu() {
  const win = new BrowserWindow()
  
  const menuTemplate = [
    {
      label: '窗口操作',
      submenu: [
        {
          label: '关闭窗口',
          click: () => win.close()
        }
      ]
    }
  ]
  
  const menu = Menu.buildFromTemplate(menuTemplate)
  win.setMenu(menu)
}

3.2.2 共享菜单架构

class MenuManager {
  constructor() {
    this.sharedTemplate = []
    this.windowMenus = new Map()
  }

  registerWindow(winId, template) {
    const mergedTemplate = [...this.sharedTemplate, ...template]
    const menu = Menu.buildFromTemplate(mergedTemplate)
    this.windowMenus.set(winId, menu)
  }
}

四、菜单系统进阶优化

4.1 性能优化策略

4.1.1 菜单懒加载

let cachedMenu = null

function getMenu() {
  if (!cachedMenu) {
    cachedMenu = Menu.buildFromTemplate(heavyTemplate)
  }
  return cachedMenu
}

4.1.2 内存管理

// 窗口关闭时释放菜单
win.on('closed', () => {
  win.setMenu(null)
  win = null
})

4.2 安全增强方案

4.2.1 沙箱环境下的菜单限制

// 禁用危险操作
{
  label: '危险操作',
  enabled: false,
  visible: process.env.NODE_ENV === 'development'
}

4.2.2 输入验证

{
  label: '执行命令',
  click: () => {
    if (validateCommand(safeCommand)) {
      execute(safeCommand)
    }
  }
}

五、跨平台适配最佳实践

5.1 macOS 特殊处理

5.1.1 应用菜单增强

if (process.platform === 'darwin') {
  template.unshift({
    label: app.name,
    submenu: [
      { role: 'about' },
      { type: 'separator' },
      { role: 'services' },
      { type: 'separator' },
      { role: 'hide' },
      { role: 'hideOthers' },
      { role: 'unhide' },
      { type: 'separator' },
      { role: 'quit' }
    ]
  })
}

5.2 Windows 优化方案

5.2.1 快捷键显示优化

{
  label: '保存',
  accelerator: 'Ctrl+S',
  acceleratorWhenHidden: true // 强制显示快捷键
}

5.2.2 高DPI适配

const menu = Menu.buildFromTemplate(template)
menu.items.forEach(item => {
  item.icon = nativeImage.createFromPath('icon@2x.png')
})

六、企业级应用案例

6.1 复杂编辑器菜单架构

6.1.1 分层菜单系统

const editorMenu = {
  label: '编辑',
  submenu: [
    { role: 'undo' },
    { role: 'redo' },
    { type: 'separator' },
    {
      label: '代码操作',
      submenu: [
        { label: '格式化' },
        { label: '重构' },
        { label: '分析' }
      ]
    }
  ]
}

6.1.2 插件化菜单扩展

function loadPluginMenus() {
  plugins.forEach(plugin => {
    const menuItem = {
      label: plugin.name,
      submenu: plugin.getMenuItems()
    }
    mainTemplate.push(menuItem)
  })
}

6.2 多语言菜单实现

6.2.1 动态国际化

function buildLocalizedMenu(lang) {
  return {
    label: i18n.t('menu.file', { lang }),
    submenu: [
      { label: i18n.t('menu.newFile', { lang }) }
    ]
  }
}

6.2.2 RTL 布局支持

/* 菜单样式适配 */
.menu:dir(rtl) {
  text-align: right;
  padding-right: 20px;
}

七、调试与测试方案

7.1 菜单调试工具

7.1.1 开发工具集成

// 开启调试模式
Menu.setApplicationMenu(Menu.buildFromTemplate([
  {
    label: '调试',
    submenu: [
      { role: 'toggleDevTools' }
    ]
  }
]))

7.2 自动化测试

7.2.1 Spectron 测试示例

describe('Menu Test', () => {
  it('should have correct menu items', async () => {
    const menu = await app.client.getMenu()
    assert(menu.find(item => item.label === '文件'))
  })
})