More control over menus

docs/src/content/docs/changelog.mdx

@@ -40,6 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - New Menu guide by [@leaanthony](https://github.com/leaanthony)
 - Add doc comments for Service API by [@fbbdev](https://github.com/fbbdev) in [#4024](https://github.com/wailsapp/wails/pull/4024)
 - Add function `application.NewServiceWithOptions` to initialise services with additional configuration by [@leaanthony](https://github.com/leaanthony) in [#4024](https://github.com/wailsapp/wails/pull/4024)
+- Add function `Menu.Clear` and `Menu.Prepend` for more menu control by [@FalcoG](https://github.com/FalcoG) in [#4031](https://github.com/wailsapp/wails/pull/4031)
 
 ### Fixed
 

docs/src/content/docs/guides/menus.mdx

@@ -56,6 +56,40 @@ submenu.Add("Open")
 submenu.Add("Save")
 ```
 
+#### Combining menus
+A menu can be added into another menu by appending or prepending it.
+```go
+menu := application.NewMenu()
+menu.Add("First Menu")
+
+secondaryMenu := application.NewMenu()
+secondaryMenu.Add("Second Menu")
+
+// insert 'secondaryMenu' after 'menu'
+menu.Append(secondaryMenu)
+
+// insert 'secondaryMenu' before 'menu'
+menu.Prepend(secondaryMenu)
+
+// update the menu
+menu.Update()
+```
+
+#### Clearing a menu
+In some cases it'll be better to construct a whole new menu if you are working with a variable amount of menu items.
+
+This will clear all items on an existing menu and allows you to add items again.
+
+```go
+menu := application.NewMenu()
+menu.Add("Waiting for update...")
+
+// after certain logic, the menu has to be updated
+menu.Clear()
+menu.Add("Update complete!")
+menu.Update()
+```
+
 ### Menu Item Properties
 
 Menu items have several properties that can be configured:

v3/pkg/application/menu.go

@@ -69,6 +69,11 @@ func (m *Menu) Update() {
 	m.impl.update()
 }
 
+// Remove all menu items
+func (m *Menu) Clear() {
+	m.items = nil
+}
+
 func (m *Menu) AddSubmenu(s string) *Menu {
 	result := NewSubMenuItem(s)
 	m.items = append(m.items, result)
@@ -186,10 +191,16 @@ func (m *Menu) Clone() *Menu {
 	return result
 }
 
+// Insert menu after an existing menu
 func (m *Menu) Append(in *Menu) {
 	m.items = append(m.items, in.items...)
 }
 
+// Insert menu before an existing menu
+func (m *Menu) Prepend(in *Menu) {
+	m.items = append(in.items, m.items...)
+}
+
 func (a *App) NewMenu() *Menu {
 	return &Menu{}
 }