SuperAPI AI 工具集

tauri-app-positioner

前端与建站

查看项目

更新于 10-16 07:54

技能介绍

用途

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 显示器上的缩放因子,因为它会影响坐标计算。

适用场景

  • 需要让弹窗或托盘窗口贴近系统托盘图标
  • 需要在多显示器环境中对齐窗口
  • 需要跨平台保持一致的窗口摆放

限制

资料中未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的更多信息,相关内容暂未提供。