Positioner プラグインで位置を調整する

Recipe ID: plugin-010

tauri-plugin-positioner は、ウィンドウを「画面の右下」や「現在のアクティブウィンドウの中央」など、特定の位置に簡単に移動させるためのプラグインです。

前提条件

Permissions (権限) の設定

src-tauri/capabilities/default.json に以下の権限を追加します。

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

1. セットアップ

npm run tauri add positioner

src-tauri/src/lib.rs:

#[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. 基本的な使用方法

Rust 側、または JavaScript 側からウィンドウを移動できます。

フロントエンドから操作

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

// 現在のウィンドウをスクリーンの右下に移動
await moveWindow(Position.BottomRight);

// 中央に移動
await moveWindow(Position.Center);

Rust 側から操作 (Window 作成時など)

use tauri_plugin_positioner::{WindowExt, Position};

// setup フック内などで
let window = app.get_webview_window("main").unwrap();
let _ = window.move_window(Position::TopRight);

Position 列挙子は以下の位置をサポートしています:

概要 (Position)説明
TopLeft画面の左上
TopRight画面の右上
BottomLeft画面の左下
BottomRight画面の右下
TopCenter画面の上部中央
BottomCenter画面の下部中央
LeftCenter画面の左側中央
RightCenter画面の右側中央
Center画面の中央

参考: docs.rs - Position