tray
Classes
TrayIcon
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
Extends
Properties
Property | Modifier | Type | Description | Defined in |
---|---|---|---|---|
id | public | string | The id associated with this tray icon. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L142 |
Accessors
rid
Returns
number
Inherited from
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L242
Methods
close()
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
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L254
setIcon()
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:
Parameters
Parameter | Type |
---|---|
icon | | null | string | Uint8Array | number [] | ArrayBuffer | Image |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L206
setIconAsTemplate()
Sets the current icon as a template. macOS only
Parameters
Parameter | Type |
---|---|
asTemplate | boolean |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L274
setMenu()
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 | null | Submenu | Menu |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L223
setMenuOnLeftClick()
Disable or enable showing the tray menu on left click. macOS only.
Parameters
Parameter | Type |
---|---|
onLeft | boolean |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L282
setTempDirPath()
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 | null | string |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L269
setTitle()
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 | null | string |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L254
setTooltip()
Sets the tooltip for this tray icon.
Platform-specific:
- Linux: Unsupported
Parameters
Parameter | Type |
---|---|
tooltip | null | string |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L238
setVisible()
Show or hide this tray icon.
Parameters
Parameter | Type |
---|---|
visible | boolean |
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L259
getById()
Gets a tray icon using the provided id.
Parameters
Parameter | Type |
---|---|
id | string |
Returns
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L150
new()
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
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L174
removeById()
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
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L162
Interfaces
TrayIconOptions
TrayIcon
creation options
Properties
Property | Type | Description | Defined in |
---|---|---|---|
action? | (event : TrayIconEvent ) => void | A handler for an event on the tray icon. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L119 |
icon? | | string | Uint8Array | number [] | ArrayBuffer | Image | 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: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L89 |
iconAsTemplate? | boolean | Use the icon as a template. macOS only. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L115 |
id? | string | The tray icon id. If undefined, a random one will be assigned | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L76 |
menu? | Submenu | Menu | The tray icon menu | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L78 |
menuOnLeftClick? | boolean | Whether to show the tray menu on left click or not, default is true . macOS only. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L117 |
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: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L111 |
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: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L104 |
tooltip? | string | The tray icon tooltip | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L91 |
Type Aliases
MouseButton
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L11
MouseButtonState
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L10
TrayIconClickEvent
Type declaration
Name | Type | Description | Defined in |
---|---|---|---|
button | MouseButton | Mouse button that triggered this event. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L35 |
buttonState | MouseButtonState | Mouse button state when this event was triggered. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L37 |
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L33
TrayIconEvent
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.
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L48
TrayIconEventBase<T>
Type Parameters
Type Parameter |
---|
T extends TrayIconEventType |
Type declaration
Name | Type | Description | Defined in |
---|---|---|---|
id | string | Id of the tray icon which triggered this event. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L23 |
position | PhysicalPosition | Physical position of the click the triggered this event. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L25 |
rect | object | Position and size of the tray icon. | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L27 |
rect.position | PhysicalPosition | - | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L28 |
rect.size | PhysicalSize | - | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L29 |
type | T | The tray icon event type | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L21 |
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L19
TrayIconEventType
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/tray.ts#L12
© 2024 Tauri Contributors. CC-BY / MIT