tray

Classes

TrayIcon

Source: undefined

Tray icon class and associated methods. This type constructor is private, instead, you should use the static method TrayIcon.new.

Warning

Unlike Rust, javascript does not have any way to run cleanup code when an object is being removed by garbage collection, but this tray icon will be cleaned up when the tauri app exists, however if you want to cleanup this object early, you need to call TrayIcon.close.

Example

import { TrayIcon } from '@tauri-apps/api/tray';
const tray = await TrayIcon.new({ tooltip: 'awesome tray tooltip' });
tray.set_tooltip('new tooltip');

Extends

• Resource

Properties

Property	Modifier	Type	Description	Defined in
id	public	string	The id associated with this tray icon.	Source: undefined

Accessors

rid

Get Signature

get rid(): number;

Source: undefined

Returns

number

Inherited from

Resource.rid

Methods

[asyncDispose]()

asyncDispose: Promise<void>;

Source: undefined

Returns

Promise<void>

Inherited from

Resource.[asyncDispose]

close()

close(): Promise<void>;

Source: undefined

Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.

Returns

Promise<void>

Inherited from

Resource.close

setIcon()

setIcon(icon): Promise<void>;

Source: undefined

Sets a new tray icon. If null is provided, it will remove the icon.

Note that you may need the image-ico or image-png Cargo features to use this API. To enable it, change your Cargo.toml file:

[dependencies]
tauri = { version = "...", features = ["...", "image-png"] }

Parameters

Parameter	Type
icon	| string | Image | ArrayBuffer | Uint8Array<ArrayBufferLike> | number[] | null

Returns

Promise<void>

setIconAsTemplate()

setIconAsTemplate(asTemplate): Promise<void>;

Source: undefined

Sets the current icon as a template. macOS only

Parameters

Parameter	Type
asTemplate	boolean

Returns

Promise<void>

setIconWithAsTemplate()

setIconWithAsTemplate(icon, asTemplate): Promise<void>;

Source: undefined

Sets a new tray icon and template status atomically. macOS only.

Note that you may need the image-ico or image-png Cargo features to use this API. To enable it, change your Cargo.toml file:

[dependencies]
tauri = { version = "...", features = ["...", "image-png"] }

Parameters

Parameter	Type
icon	| string | Image | ArrayBuffer | Uint8Array<ArrayBufferLike> | number[] | null
asTemplate	boolean

Returns

Promise<void>

setMenu()

setMenu(menu): Promise<void>;

Source: undefined

Sets a new tray menu.

Platform-specific:

• Linux: once a menu is set it cannot be removed so null has no effect

Parameters

Parameter	Type
menu	| Submenu | Menu | null

Returns

Promise<void>

setMenuOnLeftClick()

setMenuOnLeftClick(onLeft): Promise<void>;

Source: undefined

Disable or enable showing the tray menu on left click.

Platform-specific:

• Linux: Unsupported.

Parameters

Parameter	Type
onLeft	boolean

Returns

Promise<void>

Deprecated

use TrayIcon.setShowMenuOnLeftClick instead.

setShowMenuOnLeftClick()

setShowMenuOnLeftClick(onLeft): Promise<void>;

Source: undefined

Disable or enable showing the tray menu on left click.

Platform-specific:

• Linux: Unsupported.

Parameters

Parameter	Type
onLeft	boolean

Returns

Promise<void>

Since

2.2.0

setTempDirPath()

setTempDirPath(path): Promise<void>;

Source: undefined

Sets the tray icon temp dir path. Linux only.

On Linux, we need to write the icon to the disk and usually it will be $XDG_RUNTIME_DIR/tray-icon or $TEMP/tray-icon.

Parameters

Parameter	Type
path	string | null

Returns

Promise<void>

setTitle()

setTitle(title): Promise<void>;

Source: undefined

Sets the tooltip for this tray icon.

Platform-specific:

• Linux: The title will not be shown unless there is an icon as well. The title is useful for numerical and other frequently updated information. In general, it shouldn’t be shown unless a user requests it as it can take up a significant amount of space on the user’s panel. This may not be shown in all visualizations.
• Windows: Unsupported

Parameters

Parameter	Type
title	string | null

Returns

Promise<void>

setTooltip()

setTooltip(tooltip): Promise<void>;

Source: undefined

Sets the tooltip for this tray icon.

Platform-specific:

• Linux: Unsupported

Parameters

Parameter	Type
tooltip	string | null

Returns

Promise<void>

setVisible()

setVisible(visible): Promise<void>;

Source: undefined

Show or hide this tray icon.

Parameters

Parameter	Type
visible	boolean

Returns

Promise<void>

getById()

static getById(id): Promise<TrayIcon | null>;

Source: undefined

Gets a tray icon using the provided id.

Parameters

Parameter	Type
id	string

Returns

Promise<TrayIcon | null>

new()

static new(options?): Promise<TrayIcon>;

Source: undefined

Creates a new TrayIcon

Platform-specific:

• Linux: Sometimes the icon won’t be visible unless a menu is set. Setting an empty Menu is enough.

Parameters

Parameter	Type
options?	TrayIconOptions

Returns

Promise<TrayIcon>

removeById()

static removeById(id): Promise<void>;

Source: undefined

Removes a tray icon using the provided id from tauri’s internal state.

Note that this may cause the tray icon to disappear if it wasn’t cloned somewhere else or referenced by JS.

Parameters

Parameter	Type
id	string

Returns

Promise<void>

Interfaces

TrayIconOptions

Source: undefined

`TrayIcon` creation options

Properties

Property	Type	Description	Defined in
action?	(event) => void	A handler for an event on the tray icon.	Source: undefined
icon?	| string | Image | ArrayBuffer | Uint8Array<ArrayBufferLike> | number[]	The tray icon which could be icon bytes or path to the icon file. Note that you may need the image-ico or image-png Cargo features to use this API. To enable it, change your Cargo.toml file: [dependencies] tauri = { version = "...", features = ["...", "image-png"] }	Source: undefined
iconAsTemplate?	boolean	Use the icon as a template. macOS only.	Source: undefined
id?	string	The tray icon id. If undefined, a random one will be assigned	Source: undefined
menu?	| Submenu | Menu	The tray icon menu	Source: undefined
menuOnLeftClick?	boolean	Whether to show the tray menu on left click or not, default is true. Platform-specific: - Linux: Unsupported. Deprecated use TrayIconOptions.showMenuOnLeftClick instead.	Source: undefined
showMenuOnLeftClick?	boolean	Whether to show the tray menu on left click or not, default is true. Platform-specific: - Linux: Unsupported. Since 2.2.0	Source: undefined
tempDirPath?	string	The tray icon temp dir path. Linux only. On Linux, we need to write the icon to the disk and usually it will be $XDG_RUNTIME_DIR/tray-icon or $TEMP/tray-icon.	Source: undefined
title?	string	The tray title Platform-specific - Linux: The title will not be shown unless there is an icon as well. The title is useful for numerical and other frequently updated information. In general, it shouldn’t be shown unless a user requests it as it can take up a significant amount of space on the user’s panel. This may not be shown in all visualizations. - Windows: Unsupported.	Source: undefined
tooltip?	string	The tray icon tooltip	Source: undefined

Type Aliases

MouseButton

type MouseButton = "Left" | "Right" | "Middle";

Source: undefined

---

MouseButtonState

type MouseButtonState = "Up" | "Down";

Source: undefined

---

TrayIconClickEvent

type TrayIconClickEvent = object;

Source: undefined

Properties

Property	Type	Description	Defined in
button	MouseButton	Mouse button that triggered this event.	Source: undefined
buttonState	MouseButtonState	Mouse button state when this event was triggered.	Source: undefined

---

TrayIconEvent

type TrayIconEvent =
  | TrayIconEventBase<"Click"> & TrayIconClickEvent
  | TrayIconEventBase<"DoubleClick"> & Omit<TrayIconClickEvent, "buttonState">
  | TrayIconEventBase<"Enter">
  | TrayIconEventBase<"Move">
| TrayIconEventBase<"Leave">;

Source: undefined

Describes a tray icon event.

Platform-specific:

• Linux: Unsupported. The event is not emitted even though the icon is shown, the icon will still show a context menu on right click.

---

TrayIconEventBase

type TrayIconEventBase<T> = object;

Source: undefined

Type Parameters

Type Parameter
T extends TrayIconEventType

Properties

Property	Type	Description	Defined in
id	string	Id of the tray icon which triggered this event.	Source: undefined
position	PhysicalPosition	Physical position of the click the triggered this event.	Source: undefined
rect	object	Position and size of the tray icon.	Source: undefined
rect.position	PhysicalPosition	-	Source: undefined
rect.size	PhysicalSize	-	Source: undefined
type	T	The tray icon event type	Source: undefined

---

TrayIconEventType

type TrayIconEventType = "Click" | "DoubleClick" | "Enter" | "Move" | "Leave";

Source: undefined