Posicionador

GitHubnpmcrates.io

Referencia de API

Posiciona tus ventanas en ubicaciones bien conocidas.

Este plugin es un port de electron-positioner para Tauri.

Plataformas Soportadas

Este plugin requiere una versión de Rust de al menos 1.77.2

Plataforma	Nivel	Notas
windows
linux
macos
android
ios

Configuración

Instala el plugin positioner para comenzar.

Nota

Si solo tienes la intención de mover la ventana desde el código de Rust, solo necesitas la dependencia en src-tauri/Cargo.toml y puedes eliminar el registro del plugin de lib.rs si decides configurarlo automáticamente.

Automático

Usa el gestor de paquetes de tu proyecto para agregar la dependencia:

npm

npm run tauri add positioner

yarn

yarn run tauri add positioner

pnpm

pnpm tauri add positioner

deno

deno task tauri add positioner

bun

bun tauri add positioner

cargo

cargo tauri add positioner

Manual

1. Ejecuta el siguiente comando en la carpeta src-tauri para agregar el plugin a las dependencias del proyecto en Cargo.toml:

   cargo add tauri-plugin-positioner --target 'cfg(any(target_os = "macos", windows, target_os = "linux"))'

2. Modifica lib.rs para inicializar el plugin:

   src-tauri/src/lib.rs

   #[cfg_attr(mobile, tauri::mobile_entry_point)]
   pub fn run() {
       tauri::Builder::default()
           .setup(|app| {
               #[cfg(desktop)]
               app.handle().plugin(tauri_plugin_positioner::init());
               Ok(())
           })
           .run(tauri::generate_context!())
           .expect("error while running tauri application");
   }

3. Instala los bindings de JavaScript utilizando tu gestor de paquetes de JavaScript preferido:

   npm

   npm install @tauri-apps/plugin-positioner

   yarn

   yarn add @tauri-apps/plugin-positioner

   pnpm

   pnpm add @tauri-apps/plugin-positioner

   deno

   deno add npm:@tauri-apps/plugin-positioner

   bun

   bun add @tauri-apps/plugin-positioner

Se requiere una configuración adicional para que funcionen las posiciones relativas a la bandeja (tray).

1. Añade la característica tray-icon a tu archivo Cargo.toml:

   src-tauri/Cargo.toml

   [dependencies]
   tauri-plugin-positioner = { version = "2.0.0", features = ["tray-icon"] }

2. Configura on_tray_event para el plugin positioner:

   src-tauri/src/lib.rs

   pub fn run() {
     tauri::Builder::default()
       // This is required to get tray-relative positions to work
       .setup(|app| {
           #[cfg(desktop)]
           {
             app.handle().plugin(tauri_plugin_positioner::init());
               tauri::tray::TrayIconBuilder::new()
                 .on_tray_icon_event(|tray_handle, event| {
                   tauri_plugin_positioner::on_tray_event(tray_handle.app_handle(), &event);
                 })
                 .build(app)?;
           }
         Ok(())
       })
       .run(tauri::generate_context!())
       .expect("error while running tauri application");
   }

Uso

Las APIs del plugin están disponibles a través de los bindings guest de JavaScript:

import { moveWindow, Position } from '@tauri-apps/plugin-positioner';
// when using `"withGlobalTauri": true`, you may use
// const { moveWindow, Position } = window.__TAURI__.positioner;

moveWindow(Position.TopRight);

Puedes importar y usar la extensión del trait Window directamente mediante Rust:

use tauri_plugin_positioner::{WindowExt, Position};

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

Permisos

De forma predeterminada, todos los comandos y alcances (scopes) potencialmente peligrosos del plugin están bloqueados y no se puede acceder a ellos. Debes modificar los permisos en tu configuración de capabilities para habilitarlos.

Consulta la Visión General de Capacidades para obtener más información y la guía paso a paso para usar permisos de plugins.

src-tauri/capabilities/default.json

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

Permiso Predeterminado

Permite las APIs moveWindow y handleIconState

Este conjunto de permisos predeterminado incluye lo siguiente:

• allow-move-window
• allow-move-window-constrained
• allow-set-tray-icon-state

Tabla de Permisos

Identificador	Descripción
positioner:allow-move-window	Habilita el comando move_window sin ningún scope preconfigurado.
positioner:deny-move-window	Deniega el comando move_window sin ningún scope preconfigurado.
positioner:allow-move-window-constrained	Habilita el comando move_window_constrained sin ningún scope preconfigurado.
positioner:deny-move-window-constrained	Deniega el comando move_window_constrained sin ningún scope preconfigurado.
positioner:allow-set-tray-icon-state	Habilita el comando set_tray_icon_state sin ningún scope preconfigurado.
positioner:deny-set-tray-icon-state	Deniega el comando set_tray_icon_state sin ningún scope preconfigurado.