Wails v3 菜单系统实战从零构建跨平台原生菜单Menu Example 深度解析【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails本指南以 Wails v3 示例仓库中的 menu 示例 为骨架深入讲解如何在纯 Go 侧构建一套完整的跨平台应用菜单包括菜单角色Role、子菜单、复选与单选菜单项、快捷键Accelerator、动态隐藏/禁用等交互状态控制。读完本文你将掌握application.NewMenu()系列 API 的完整用法理解菜单点击回调的底层分发机制并能在 macOS、Windows、Linux 上写出一份可复用的应用菜单代码。示例概览不依赖 npm 的原生菜单演示Wails v3 的菜单系统完全由 Go 驱动不依赖任何前端框架或 npm 包。menu示例位于 v3/examples/menu/main.go它演示了创建应用菜单的多种方式并重点展示菜单项的动态状态切换隐藏/显示、禁用/启用、标签修改与回调共享等实战技巧。运行示例非常简单在示例目录下执行go run .平台支持状态原 README 中明确给出了各平台的支持情况平台状态Mac可用Windows可用Linux支持中README 中未标注为 Working已知问题README 记录了一个已知问题当窗口不可调整大小时调整大小的光标仍然可见Resize cursor still visible when not resizable。在规划窗口交互与菜单联动时需要注意这一平台行为差异。应用骨架创建应用与窗口示例程序的入口遵循 Wails v3 标准流程。首先通过application.New创建应用实例其中Assets使用了application.AlphaAssets内嵌的演示资源并针对 macOS 设置了关闭最后一个窗口后自动退出应用app : application.New(application.Options{ Name: Menu Demo, Description: A demo of the menu system, Assets: application.AlphaAssets, Mac: application.MacOptions{ ApplicationShouldTerminateAfterLastWindowClosed: true, }, })随后创建 Webview 窗口注意窗口选项中的关键字段UseApplicationMenu: true它的作用是让 Windows/Linux 上的窗口继承应用级菜单macOS 的菜单天然位于系统菜单栏无需此设置app.Window.NewWithOptions(application.WebviewWindowOptions{ Name: menu-example, Title: Menu Example, UseApplicationMenu: true, }).SetBackgroundColour(application.NewRGB(33, 37, 41)) err : app.Run() if err ! nil { log.Fatal(err.Error()) }从源码看UseApplicationMenu是 WebviewWindowOptions 的字段在 Windowswebview_window_windows.go与 Linuxwebview_window_linux.go的窗口创建路径中都会检查globalApplication.applicationMenu是否非空从而决定是否把应用菜单挂接到该窗口。构建菜单角色、子菜单与菜单项从应用创建菜单应用实例通过app.NewMenu()创建菜单对象最终通过app.Menu.Set(menu)注册为应用菜单。从源码看MenuManager.Set实际调用SetApplicationMenu将菜单写入mm.app.applicationMenu并在平台实现就绪时同步到底层见 menu_manager.go。menu : app.NewMenu() ... app.Menu.Set(menu)菜单角色Role一行代码获得标准菜单示例使用AddRole快速装配了五个标准菜单。角色菜单由 Wails 根据平台自动生成合适的标准条目无需手工逐项创建if runtime.GOOS darwin { menu.AddRole(application.AppMenu) // 仅 macOS 需要 App 菜单 } menu.AddRole(application.FileMenu) menu.AddRole(application.EditMenu) menu.AddRole(application.WindowMenu) menu.AddRole(application.HelpMenu)在 menuitem.go 的NewRole中可以看到完整的角色清单包括AppMenu、EditMenu、FileMenu、ViewMenu、ServicesMenu、SpeechMenu、WindowMenu、HelpMenu以及细粒度的动作角色如Undo、Redo、Cut、Copy、Paste、SelectAll、Quit、CloseWindow、About、Reload、ToggleFullscreen、OpenDevTools、ZoomIn、ZoomOut、Minimise、FullScreen、Print、NewFile、Open、Save、SaveAs、Find等。遇到未识别的角色框架会通过globalApplication.error记录“no support for role”错误。自定义子菜单AddSubmenu返回一个新的*Menu可以继续在其上追加菜单项形成层级结构。示例中的 Demo 菜单是后续所有交互演示的容器myMenu : menu.AddSubmenu(Demo)嵌套子菜单同样简单示例末尾展示了三级结构submenu : myMenu.AddSubmenu(Submenu) submenu.Add(Submenu item 1) submenu.Add(Submenu item 2) submenu.Add(Submenu item 3)Add系列方法返回*MenuItem支持链式调用。所有菜单类型文本、分隔符、复选框、单选、子菜单在源码 menuitem.go 中由menuItemType枚举区分text、separator、checkbox、radio、submenu。每个菜单项在创建时都会分配全局递增的 ID 并注册进menuItemMap见 menuitem.go这是点击回调能够精确路由到对应菜单项的关键。菜单项状态控制隐藏、禁用与动态标签隐藏与切换隐藏创建时即可设置初始隐藏状态再通过另一菜单项在运行时切换hidden : myMenu.Add(I was hidden).SetHidden(true) myMenu.Add(Toggle the hidden menu).OnClick(func(ctx *application.Context) { hidden.SetHidden(!hidden.Hidden()) })禁用与启用myMenu.Add(Not Enabled).SetEnabled(false)SetEnabled(false)底层会把disabled置为 trueEnabled()返回!m.disabled见 menuitem.go。动态修改标签菜单项在回调中可以直接修改自己的标签实现“状态即文案”的交互模式myMenu.Add(Click Me!).SetAccelerator(CmdOrCtrll).OnClick(func(ctx *application.Context) { switch ctx.ClickedMenuItem().Label() { case Click Me!: ctx.ClickedMenuItem().SetLabel(Thanks mate!) case Thanks mate!: ctx.ClickedMenuItem().SetLabel(Click Me!) } })ctx.ClickedMenuItem()返回被点击的*MenuItem引用从而实现对菜单项自身的读写操作。控制窗口行为菜单回调可以直接操作当前窗口示例演示了锁定/解锁窗口缩放myMenu.Add(Lock WebviewWindow Resize).OnClick(func(ctx *application.Context) { if app.Window.Current().Resizable() { app.Window.Current().SetResizable(false) ctx.ClickedMenuItem().SetLabel(Unlock WebviewWindow Resize) } else { app.Window.Current().SetResizable(true) ctx.ClickedMenuItem().SetLabel(Lock WebviewWindow Resize) } })这里用到了app.Window.Current()获取当前窗口是菜单与窗口能力联动的典型场景。复选菜单项状态由框架托管复选框菜单项的状态切换由框架自动完成——点击时框架先翻转checked状态再把新状态注入上下文回调中无需自行维护布尔值myMenu.AddCheckbox(My checkbox, true).OnClick(func(context *application.Context) { println(Clicked checkbox. Checked:, context.ClickedMenuItem().Checked()) })在handleClick的源码实现中menuitem.gocheckbox 类型会执行m.checked !m.checked并通过ctx.withChecked(m.checked)把新状态传给回调随后同步到平台实现m.impl.setChecked(...)。AddCheckbox(label, checked)的第二个参数即初始勾选状态。单选菜单组相邻即分组单选菜单组是示例中一个非常实用的特性不需要显式声明分组只要把多个 radio 菜单项连续放在同一菜单中它们就自动构成一组。源码 menu.go 的processRadioGroups在菜单Update()时扫描菜单项列表遇到 radio 类型就把相邻的 radio 项收进同一个radioGroupMembers组遇到非 radio 项或子菜单时关闭当前组。radioCallback : func(ctx *application.Context) { menuItem : ctx.ClickedMenuItem() menuItem.SetLabel(menuItem.Label() !) } myMenu.AddRadio(Radio 1, true).OnClick(radioCallback) myMenu.AddRadio(Radio 2, false).OnClick(radioCallback) myMenu.AddRadio(Radio 3, false).OnClick(radioCallback)示例还演示了回调共享三个单选菜单项共用同一个radioCallback这正是AddRadio返回*MenuItem且OnClick接收*Context的价值所在。单选组的行为同样由handleClick驱动点击组内某一项时框架会把组内所有成员的checked置为 false再将被点击项置为 true并同步各平台实现的选中状态。初始选中项通过AddRadio(label, true)指定示例中为 Radio 1。快捷键Accelerator跨平台按键映射SetAccelerator为菜单项绑定全局快捷键。示例中的CmdOrCtrll是一个跨平台写法macOS 上映射为 CommandLWindows/Linux 上映射为 CtrlL。myMenu.Add(Click Me!).SetAccelerator(CmdOrCtrll).OnClick(...)从 keys.go 源码可以看到完整的解析与映射规则修饰键定义于 keys.goCmdOrCtrlKeyMac 为 Cmd其余为 Ctrl、OptionOrAltKeyMac 为 Option其余为 Alt、ShiftKey、SuperKeyMac 为 CmdWindows 为 WinLinux 为 Super、ControlKey全平台 Ctrl。修饰键别名keys.go支持cmdorctrl、cmd、command、ctrl、optionoralt、alt、option、shift、super等多种写法。命名按键keys.gobackspace、tab、return、enter、escape、方向键、space、delete、home、end、page up、page down、f1~f19等单个可打印字符如l也可直接作为按键。解析规则keys.go快捷键字符串按拆分除最后一段为按键外其余段必须是合法修饰键否则返回错误并通过globalApplication.error记录 invalid accelerator。搭配GetAccelerator()、RemoveAccelerator()见 menuitem.go可在运行时查询或移除菜单项的快捷键。高级交互菜单项之间的联动控制示例后半部分展示了菜单项之间的引用联动——一个菜单项可以动态操控另一个菜单项的状态这是构建“设置类菜单”的常用模式禁用/启用联动beatles : myMenu.Add(Hello).OnClick(func(*application.Context) { println(The beatles would be proud) }) myMenu.Add(Toggle the menuitem above).OnClick(func(*application.Context) { if beatles.Enabled() { beatles.SetEnabled(false) beatles.SetLabel(Goodbye) } else { beatles.SetEnabled(true) beatles.SetLabel(Hello) } })隐藏/显示联动myMenu.Add(Hide the beatles).OnClick(func(ctx *application.Context) { if beatles.Hidden() { ctx.ClickedMenuItem().SetLabel(Hide the beatles!) beatles.SetHidden(false) } else { beatles.SetHidden(true) ctx.ClickedMenuItem().SetLabel(Unhide the beatles!) } })状态维护示例示例用一个“咖啡机”的比喻完整演示了 Enabled/Hidden 四种状态的组合管理coffee : myMenu.Add(Request Coffee).OnClick(func(*application.Context) { println(Coffee dispatched. Productivity 10!) }) myMenu.Add(Toggle coffee availability).OnClick(func(*application.Context) { if coffee.Enabled() { coffee.SetEnabled(false) coffee.SetLabel(Coffee Machine Broken) println(Alert: Developer morale critically low.) } else { coffee.SetEnabled(true) coffee.SetLabel(Request Coffee) println(All systems nominal. Coffee restored.) } }) myMenu.Add(Hide the coffee option).OnClick(func(ctx *application.Context) { if coffee.Hidden() { ctx.ClickedMenuItem().SetLabel(Hide the coffee option) coffee.SetHidden(false) } else { coffee.SetHidden(true) ctx.ClickedMenuItem().SetLabel(Unhide the coffee option) } })点击回调的底层机制理解菜单事件如何到达 Go 回调有助于排查复杂的菜单交互问题。核心链路如下平台层捕获菜单点击将菜单项 ID 回传MenuManager.handleMenuItemClicked(menuItemID)通过全局注册表getMenuItemByID反查*MenuItem见 menu_manager.go查不到时记录 MenuItem #N not found 警告调用menuItem.handleClick()menuitem.gocheckbox 翻转状态、radio 组内互斥然后构造带ClickedMenuItem与状态信息的Context回调在独立 goroutine 中执行go func() { defer handlePanic(); m.callback(ctx) }()并带有 panic 恢复保护单个菜单回调崩溃不会拖垮整个应用。Menu 的常用管理方法除示例展示的 API 外menu.go 还提供了菜单结构化管理能力FindByLabel(label)/FindByRole(role)递归查找菜单项menu.goRemoveMenuItem(target)递归删除指定菜单项menu.goClear()/Destroy()清空或销毁全部菜单项并释放注册表资源menu.goClone()、Append(in)、Prepend(in)深拷贝、追加、前置合并菜单menu.goItemAt(index)按下标获取菜单项menu.go。MenuItem侧还支持SetTooltip、SetBitmap图标、SetRole、SetChecked、GetSubmenu及IsSeparator/IsSubmenu/IsCheckbox/IsRadio等类型判断方法menuitem.go可满足工具栏图标、工具提示等进阶需求。小结与延伸阅读menu示例以极小的代码量覆盖了 Wails v3 菜单系统的核心能力角色菜单、自定义子菜单、复选/单选分组、跨平台快捷键、隐藏/禁用/标签的动态切换以及菜单与窗口、回调共享的组合用法。相比依赖前端渲染的菜单方案这套纯 Go 菜单 API 让桌面应用的顶层交互完全可控且易于测试。如需继续深入可阅读以下仓库源码示例入口v3/examples/menu/main.go菜单核心 APIv3/pkg/application/menu.go菜单项实现与角色表v3/pkg/application/menuitem.go菜单管理器v3/pkg/application/menu_manager.go快捷键解析与平台映射v3/pkg/application/keys.go平台实现参考macOS 见 v3/pkg/application/menu_darwin.goWindows 见 v3/pkg/application/menu_windows.goLinux 见 v3/pkg/application/menu_linux.go相关测试v3/pkg/application/menu_internal_test.go、v3/pkg/application/menuitem_internal_test.go图标来源说明示例中icon.png由 kusumapotter 创作于 Flaticon仅作为演示资源使用在真实项目中请替换为你自己的应用图标。【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Wails v3 菜单系统实战：从零构建跨平台原生菜单（Menu Example 深度解析）
Wails v3 菜单系统实战从零构建跨平台原生菜单Menu Example 深度解析【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails本指南以 Wails v3 示例仓库中的 menu 示例 为骨架深入讲解如何在纯 Go 侧构建一套完整的跨平台应用菜单包括菜单角色Role、子菜单、复选与单选菜单项、快捷键Accelerator、动态隐藏/禁用等交互状态控制。读完本文你将掌握application.NewMenu()系列 API 的完整用法理解菜单点击回调的底层分发机制并能在 macOS、Windows、Linux 上写出一份可复用的应用菜单代码。示例概览不依赖 npm 的原生菜单演示Wails v3 的菜单系统完全由 Go 驱动不依赖任何前端框架或 npm 包。menu示例位于 v3/examples/menu/main.go它演示了创建应用菜单的多种方式并重点展示菜单项的动态状态切换隐藏/显示、禁用/启用、标签修改与回调共享等实战技巧。运行示例非常简单在示例目录下执行go run .平台支持状态原 README 中明确给出了各平台的支持情况平台状态Mac可用Windows可用Linux支持中README 中未标注为 Working已知问题README 记录了一个已知问题当窗口不可调整大小时调整大小的光标仍然可见Resize cursor still visible when not resizable。在规划窗口交互与菜单联动时需要注意这一平台行为差异。应用骨架创建应用与窗口示例程序的入口遵循 Wails v3 标准流程。首先通过application.New创建应用实例其中Assets使用了application.AlphaAssets内嵌的演示资源并针对 macOS 设置了关闭最后一个窗口后自动退出应用app : application.New(application.Options{ Name: Menu Demo, Description: A demo of the menu system, Assets: application.AlphaAssets, Mac: application.MacOptions{ ApplicationShouldTerminateAfterLastWindowClosed: true, }, })随后创建 Webview 窗口注意窗口选项中的关键字段UseApplicationMenu: true它的作用是让 Windows/Linux 上的窗口继承应用级菜单macOS 的菜单天然位于系统菜单栏无需此设置app.Window.NewWithOptions(application.WebviewWindowOptions{ Name: menu-example, Title: Menu Example, UseApplicationMenu: true, }).SetBackgroundColour(application.NewRGB(33, 37, 41)) err : app.Run() if err ! nil { log.Fatal(err.Error()) }从源码看UseApplicationMenu是 WebviewWindowOptions 的字段在 Windowswebview_window_windows.go与 Linuxwebview_window_linux.go的窗口创建路径中都会检查globalApplication.applicationMenu是否非空从而决定是否把应用菜单挂接到该窗口。构建菜单角色、子菜单与菜单项从应用创建菜单应用实例通过app.NewMenu()创建菜单对象最终通过app.Menu.Set(menu)注册为应用菜单。从源码看MenuManager.Set实际调用SetApplicationMenu将菜单写入mm.app.applicationMenu并在平台实现就绪时同步到底层见 menu_manager.go。menu : app.NewMenu() ... app.Menu.Set(menu)菜单角色Role一行代码获得标准菜单示例使用AddRole快速装配了五个标准菜单。角色菜单由 Wails 根据平台自动生成合适的标准条目无需手工逐项创建if runtime.GOOS darwin { menu.AddRole(application.AppMenu) // 仅 macOS 需要 App 菜单 } menu.AddRole(application.FileMenu) menu.AddRole(application.EditMenu) menu.AddRole(application.WindowMenu) menu.AddRole(application.HelpMenu)在 menuitem.go 的NewRole中可以看到完整的角色清单包括AppMenu、EditMenu、FileMenu、ViewMenu、ServicesMenu、SpeechMenu、WindowMenu、HelpMenu以及细粒度的动作角色如Undo、Redo、Cut、Copy、Paste、SelectAll、Quit、CloseWindow、About、Reload、ToggleFullscreen、OpenDevTools、ZoomIn、ZoomOut、Minimise、FullScreen、Print、NewFile、Open、Save、SaveAs、Find等。遇到未识别的角色框架会通过globalApplication.error记录“no support for role”错误。自定义子菜单AddSubmenu返回一个新的*Menu可以继续在其上追加菜单项形成层级结构。示例中的 Demo 菜单是后续所有交互演示的容器myMenu : menu.AddSubmenu(Demo)嵌套子菜单同样简单示例末尾展示了三级结构submenu : myMenu.AddSubmenu(Submenu) submenu.Add(Submenu item 1) submenu.Add(Submenu item 2) submenu.Add(Submenu item 3)Add系列方法返回*MenuItem支持链式调用。所有菜单类型文本、分隔符、复选框、单选、子菜单在源码 menuitem.go 中由menuItemType枚举区分text、separator、checkbox、radio、submenu。每个菜单项在创建时都会分配全局递增的 ID 并注册进menuItemMap见 menuitem.go这是点击回调能够精确路由到对应菜单项的关键。菜单项状态控制隐藏、禁用与动态标签隐藏与切换隐藏创建时即可设置初始隐藏状态再通过另一菜单项在运行时切换hidden : myMenu.Add(I was hidden).SetHidden(true) myMenu.Add(Toggle the hidden menu).OnClick(func(ctx *application.Context) { hidden.SetHidden(!hidden.Hidden()) })禁用与启用myMenu.Add(Not Enabled).SetEnabled(false)SetEnabled(false)底层会把disabled置为 trueEnabled()返回!m.disabled见 menuitem.go。动态修改标签菜单项在回调中可以直接修改自己的标签实现“状态即文案”的交互模式myMenu.Add(Click Me!).SetAccelerator(CmdOrCtrll).OnClick(func(ctx *application.Context) { switch ctx.ClickedMenuItem().Label() { case Click Me!: ctx.ClickedMenuItem().SetLabel(Thanks mate!) case Thanks mate!: ctx.ClickedMenuItem().SetLabel(Click Me!) } })ctx.ClickedMenuItem()返回被点击的*MenuItem引用从而实现对菜单项自身的读写操作。控制窗口行为菜单回调可以直接操作当前窗口示例演示了锁定/解锁窗口缩放myMenu.Add(Lock WebviewWindow Resize).OnClick(func(ctx *application.Context) { if app.Window.Current().Resizable() { app.Window.Current().SetResizable(false) ctx.ClickedMenuItem().SetLabel(Unlock WebviewWindow Resize) } else { app.Window.Current().SetResizable(true) ctx.ClickedMenuItem().SetLabel(Lock WebviewWindow Resize) } })这里用到了app.Window.Current()获取当前窗口是菜单与窗口能力联动的典型场景。复选菜单项状态由框架托管复选框菜单项的状态切换由框架自动完成——点击时框架先翻转checked状态再把新状态注入上下文回调中无需自行维护布尔值myMenu.AddCheckbox(My checkbox, true).OnClick(func(context *application.Context) { println(Clicked checkbox. Checked:, context.ClickedMenuItem().Checked()) })在handleClick的源码实现中menuitem.gocheckbox 类型会执行m.checked !m.checked并通过ctx.withChecked(m.checked)把新状态传给回调随后同步到平台实现m.impl.setChecked(...)。AddCheckbox(label, checked)的第二个参数即初始勾选状态。单选菜单组相邻即分组单选菜单组是示例中一个非常实用的特性不需要显式声明分组只要把多个 radio 菜单项连续放在同一菜单中它们就自动构成一组。源码 menu.go 的processRadioGroups在菜单Update()时扫描菜单项列表遇到 radio 类型就把相邻的 radio 项收进同一个radioGroupMembers组遇到非 radio 项或子菜单时关闭当前组。radioCallback : func(ctx *application.Context) { menuItem : ctx.ClickedMenuItem() menuItem.SetLabel(menuItem.Label() !) } myMenu.AddRadio(Radio 1, true).OnClick(radioCallback) myMenu.AddRadio(Radio 2, false).OnClick(radioCallback) myMenu.AddRadio(Radio 3, false).OnClick(radioCallback)示例还演示了回调共享三个单选菜单项共用同一个radioCallback这正是AddRadio返回*MenuItem且OnClick接收*Context的价值所在。单选组的行为同样由handleClick驱动点击组内某一项时框架会把组内所有成员的checked置为 false再将被点击项置为 true并同步各平台实现的选中状态。初始选中项通过AddRadio(label, true)指定示例中为 Radio 1。快捷键Accelerator跨平台按键映射SetAccelerator为菜单项绑定全局快捷键。示例中的CmdOrCtrll是一个跨平台写法macOS 上映射为 CommandLWindows/Linux 上映射为 CtrlL。myMenu.Add(Click Me!).SetAccelerator(CmdOrCtrll).OnClick(...)从 keys.go 源码可以看到完整的解析与映射规则修饰键定义于 keys.goCmdOrCtrlKeyMac 为 Cmd其余为 Ctrl、OptionOrAltKeyMac 为 Option其余为 Alt、ShiftKey、SuperKeyMac 为 CmdWindows 为 WinLinux 为 Super、ControlKey全平台 Ctrl。修饰键别名keys.go支持cmdorctrl、cmd、command、ctrl、optionoralt、alt、option、shift、super等多种写法。命名按键keys.gobackspace、tab、return、enter、escape、方向键、space、delete、home、end、page up、page down、f1~f19等单个可打印字符如l也可直接作为按键。解析规则keys.go快捷键字符串按拆分除最后一段为按键外其余段必须是合法修饰键否则返回错误并通过globalApplication.error记录 invalid accelerator。搭配GetAccelerator()、RemoveAccelerator()见 menuitem.go可在运行时查询或移除菜单项的快捷键。高级交互菜单项之间的联动控制示例后半部分展示了菜单项之间的引用联动——一个菜单项可以动态操控另一个菜单项的状态这是构建“设置类菜单”的常用模式禁用/启用联动beatles : myMenu.Add(Hello).OnClick(func(*application.Context) { println(The beatles would be proud) }) myMenu.Add(Toggle the menuitem above).OnClick(func(*application.Context) { if beatles.Enabled() { beatles.SetEnabled(false) beatles.SetLabel(Goodbye) } else { beatles.SetEnabled(true) beatles.SetLabel(Hello) } })隐藏/显示联动myMenu.Add(Hide the beatles).OnClick(func(ctx *application.Context) { if beatles.Hidden() { ctx.ClickedMenuItem().SetLabel(Hide the beatles!) beatles.SetHidden(false) } else { beatles.SetHidden(true) ctx.ClickedMenuItem().SetLabel(Unhide the beatles!) } })状态维护示例示例用一个“咖啡机”的比喻完整演示了 Enabled/Hidden 四种状态的组合管理coffee : myMenu.Add(Request Coffee).OnClick(func(*application.Context) { println(Coffee dispatched. Productivity 10!) }) myMenu.Add(Toggle coffee availability).OnClick(func(*application.Context) { if coffee.Enabled() { coffee.SetEnabled(false) coffee.SetLabel(Coffee Machine Broken) println(Alert: Developer morale critically low.) } else { coffee.SetEnabled(true) coffee.SetLabel(Request Coffee) println(All systems nominal. Coffee restored.) } }) myMenu.Add(Hide the coffee option).OnClick(func(ctx *application.Context) { if coffee.Hidden() { ctx.ClickedMenuItem().SetLabel(Hide the coffee option) coffee.SetHidden(false) } else { coffee.SetHidden(true) ctx.ClickedMenuItem().SetLabel(Unhide the coffee option) } })点击回调的底层机制理解菜单事件如何到达 Go 回调有助于排查复杂的菜单交互问题。核心链路如下平台层捕获菜单点击将菜单项 ID 回传MenuManager.handleMenuItemClicked(menuItemID)通过全局注册表getMenuItemByID反查*MenuItem见 menu_manager.go查不到时记录 MenuItem #N not found 警告调用menuItem.handleClick()menuitem.gocheckbox 翻转状态、radio 组内互斥然后构造带ClickedMenuItem与状态信息的Context回调在独立 goroutine 中执行go func() { defer handlePanic(); m.callback(ctx) }()并带有 panic 恢复保护单个菜单回调崩溃不会拖垮整个应用。Menu 的常用管理方法除示例展示的 API 外menu.go 还提供了菜单结构化管理能力FindByLabel(label)/FindByRole(role)递归查找菜单项menu.goRemoveMenuItem(target)递归删除指定菜单项menu.goClear()/Destroy()清空或销毁全部菜单项并释放注册表资源menu.goClone()、Append(in)、Prepend(in)深拷贝、追加、前置合并菜单menu.goItemAt(index)按下标获取菜单项menu.go。MenuItem侧还支持SetTooltip、SetBitmap图标、SetRole、SetChecked、GetSubmenu及IsSeparator/IsSubmenu/IsCheckbox/IsRadio等类型判断方法menuitem.go可满足工具栏图标、工具提示等进阶需求。小结与延伸阅读menu示例以极小的代码量覆盖了 Wails v3 菜单系统的核心能力角色菜单、自定义子菜单、复选/单选分组、跨平台快捷键、隐藏/禁用/标签的动态切换以及菜单与窗口、回调共享的组合用法。相比依赖前端渲染的菜单方案这套纯 Go 菜单 API 让桌面应用的顶层交互完全可控且易于测试。如需继续深入可阅读以下仓库源码示例入口v3/examples/menu/main.go菜单核心 APIv3/pkg/application/menu.go菜单项实现与角色表v3/pkg/application/menuitem.go菜单管理器v3/pkg/application/menu_manager.go快捷键解析与平台映射v3/pkg/application/keys.go平台实现参考macOS 见 v3/pkg/application/menu_darwin.goWindows 见 v3/pkg/application/menu_windows.goLinux 见 v3/pkg/application/menu_linux.go相关测试v3/pkg/application/menu_internal_test.go、v3/pkg/application/menuitem_internal_test.go图标来源说明示例中icon.png由 kusumapotter 创作于 Flaticon仅作为演示资源使用在真实项目中请替换为你自己的应用图标。【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考