21 Positioner

原文链接: https://tauri.app/plugin/positioner/

把窗口放到众所周知的位置。

支持的平台

平台支持程度说明
Windows完整支持
Linux完整支持
macOS完整支持
Android不支持
iOS不支持

设置

自动

使用你的项目包管理器添加依赖:

1
npm run tauri add positioner
1
yarn run tauri add positioner
1
pnpm tauri add positioner
1
deno task tauri add positioner
1
bun tauri add positioner
1
cargo tauri add positioner

手动

  1. 在 src-tauri 文件夹中运行以下命令,把插件加入 Cargo.toml 里的项目依赖:

    1
    
    cargo add tauri-plugin-positioner
    
  2. 修改 lib.rs 初始化插件:

    1
    2
    3
    4
    5
    6
    7
    
    #[cfg_attr(mobile, tauri::mobile_entry_point)]
    pub fn run() {
        tauri::Builder::default()
            .plugin(tauri_plugin_positioner::init())
            .run(tauri::generate_context!())
            .expect("error while running tauri application");
    }
    
  3. 用你偏好的 JavaScript 包管理器安装 JavaScript 端绑定:

1
npm install @tauri-apps/plugin-positioner
1
yarn add @tauri-apps/plugin-positioner
1
pnpm add @tauri-apps/plugin-positioner
1
deno add npm:@tauri-apps/plugin-positioner
1
bun add @tauri-apps/plugin-positioner

用法

该插件的 API 可以通过 JavaScript 端绑定使用:

1
2
3
4
5
import { moveWindow, Position } from '@tauri-apps/plugin-positioner';
// 使用 `"withGlobalTauri": true` 时,你可以这样写
// const { moveWindow, Position } = window.__TAURI__.positioner;

moveWindow(Position.TopRight);

你也可以直接在 Rust 中导入并使用 Window trait 扩展:

1
2
3
4
use tauri_plugin_positioner::{WindowExt, Position};

let mut win = app.get_webview_window("main").unwrap();
let _ = win.as_ref().window().move_window(Position::TopRight);

权限

默认情况下,所有有潜在危险的插件命令和作用域都被阻止,无法访问。你必须在 capabilities 配置中修改权限才能启用它们。

更多信息请参阅能力概述,以及使用插件权限的分步指南。

1
2
3
4
5
6
{
  "permissions": [
    ...,
    "positioner:default"
  ]
}
最后修改 September 26, 2026: 更新 (630b11f59)