tauri·Wednesday, September 25, 2024 at 08:46:28

Tauri 定位器插件使用指南

Tauri 的定位器插件允许你将应用窗口定位到屏幕的特定位置或相对于托盘图标的位置。以下是如何在 Tauri 应用程序中使用定位器插件的步骤。

javascriptrust

Tauri 定位器插件使用指南

Tauri 的定位器插件允许你将应用窗口定位到屏幕的特定位置或相对于托盘图标的位置。以下是如何在 Tauri 应用程序中使用定位器插件的步骤。

1. 安装插件

首先，在你的 Tauri 项目中的 Cargo.toml 文件中添加定位器插件。

[dependencies]
tauri-plugin-positioner = "2.0.0-rc"

确保启用了所需的功能，例如 tray-icon。

2. 初始化插件

在你的 lib.rs 文件中，初始化定位器插件。

fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_positioner::init())
        .setup(|app| {
            let _tray = TrayIconBuilder::new()
                .on_tray_icon_event(|app, event| {
                    tauri_plugin_positioner::on_tray_event(app.app_handle(), &event);
                })
                .build(app)?;

            Ok(())
        })
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

3. 安装 JavaScript 绑定

在前端项目中，安装对应的 JavaScript 包来调用定位器的功能。

pnpm add @tauri-apps/plugin-positioner

4. 在 JavaScript 中调用插件方法

在你的 JavaScript 代码中，调用定位器插件提供的方法。

import { moveWindow, Position } from '@tauri-apps/plugin-positioner';

// 将窗口移动到屏幕右上角
moveWindow(Position.TopRight);

Position 枚举包含以下几种值：

TopLeft
TopRight
BottomLeft
BottomRight
TopCenter
BottomCenter
LeftCenter
RightCenter
Center
TrayLeft
TrayBottomLeft
TrayRight
TrayBottomRight
TrayCenter
TrayBottomCenter

注意事项

默认情况下，所有插件命令都被阻止，无法访问。你必须在 capabilities 配置中定义一个权限列表。

{
  "permissions": [
    "positioner:default"
  ]
}

参考文献:https://v2.tauri.app/zh-cn/plugin/positioner/