wails/mkdocs-website/docs/en/API/systray.md

System Tray

The system tray houses notification area on a desktop environment, which can contain both icons of currently-running applications and specific system notifications.

You create a system tray by calling app.NewSystemTray():

    // Create a new system tray
tray := app.NewSystemTray()

The following methods are available on the SystemTray type:

SetLabel

API: SetLabel(label string)

The SetLabel method sets the tray's label.

Label

API: Label() string

The Label method retrieves the tray's label.

PositionWindow

API: PositionWindow(*WebviewWindow, offset int) error

The PositionWindow method calls both AttachWindow and WindowOffset methods.

SetIcon

API: SetIcon(icon []byte) *SystemTray

The SetIcon method sets the system tray's icon.

SetDarkModeIcon

API: SetDarkModeIcon(icon []byte) *SystemTray

The SetDarkModeIcon method sets the system tray's icon when in dark mode.

SetMenu

API: SetMenu(menu *Menu) *SystemTray

The SetMenu method sets the system tray's menu.

Destroy

API: Destroy()

The Destroy method destroys the system tray instance.

OnClick

API: OnClick(handler func()) *SystemTray

The OnClick method sets the function to execute when the tray icon is clicked.

OnRightClick

API: OnRightClick(handler func()) *SystemTray

The OnRightClick method sets the function to execute when right-clicking the tray icon.

OnDoubleClick

API: OnDoubleClick(handler func()) *SystemTray

The OnDoubleClick method sets the function to execute when double-clicking the tray icon.

OnRightDoubleClick

API: OnRightDoubleClick(handler func()) *SystemTray

The OnRightDoubleClick method sets the function to execute when right double-clicking the tray icon.

AttachWindow

API: AttachWindow(window *WebviewWindow) *SystemTray

The AttachWindow method attaches a window to the system tray. The window will be shown when the system tray icon is clicked.

WindowOffset

API: WindowOffset(offset int) *SystemTray

The WindowOffset method sets the gap in pixels between the system tray and the window.

WindowDebounce

API: WindowDebounce(debounce time.Duration) *SystemTray

The WindowDebounce method sets a debounce time. In the context of Windows, this is used to specify how long to wait before responding to a mouse up event on the notification icon.

OpenMenu

API: OpenMenu()

The OpenMenu method opens the menu associated with the system tray.