用途
tauri-app-positioner 是一个针对 Tauri v2 的窗口定位技能,核心用途是使用 Tauri v2 的 positioner 插件,将窗口定位到系统托盘或屏幕的相对位置,并支持多显示器(multi-display)场景。
当用户提到以下内容时,应始终使用该技能:
- 将窗口定位到系统托盘附近
- 多显示器或多屏幕的窗口对齐
- 跨平台保持一致的窗口摆放
常见触发词包括:positioner、window position、tray window、multi-monitor、align window。
主要能力
- 使用 Position 枚举进行窗口定位
- 支持相对于系统托盘和相对于屏幕的定位
- 提供多显示器与 HiDPI 缩放的指导
使用方式
安装 positioner 插件:
cargo add tauri-plugin-positioner
在 Tauri builder 中注册插件:
use tauri_plugin_positioner::Position;
tauri::Builder::default()
.plugin(tauri_plugin_positioner::init())
在 src-tauri/capabilities/default.json 中配置 capabilities:
{ "permissions": ["positioner:allow-move-window"] }
在前端定位窗口:
import { moveWindow, Position } from '@tauri-apps/plugin-positioner';
await moveWindow(Position.TrayCenter); // center below tray icon
await moveWindow(Position.TopRight); // top-right corner of screen
await moveWindow(Position.BottomRight); // bottom-right corner
处理多显示器时,检查托盘图标位于哪个显示器,并相对于该显示器进行定位。
考虑 HiDPI 显示器上的缩放因子,因为它会影响坐标计算。
适用场景
- 需要让弹窗或托盘窗口贴近系统托盘图标
- 需要在多显示器环境中对齐窗口
- 需要跨平台保持一致的窗口摆放
限制
资料中未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的更多信息,相关内容暂未提供。