SuperAPI AI 工具集

tauri-app-window-state

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

用途:在 Tauri v2 应用中持久化并恢复窗口状态,使其在会话之间记住窗口大小、位置与最大化等布局信息。当用户提到记住窗口尺寸与位置、StateFlags 配置、窗口状态持久化或跨会话恢复位置时适用。

主要能力:通过 window-state 插件自动在应用启动时为每个窗口恢复状态,并支持按需选择要持久化的状态项。可选的状态标志包括 SIZE、POSITION、MAXIMIZED、VISIBLE、DECORATIONS、FULLSCREEN,可组合使用。

使用方式:先用 cargo add tauri-plugin-window-state 添加插件;注册插件并设置状态标志,例如使用 tauri_plugin_window_state::Builder::new().with_state_flags(StateFlags::SIZE | StateFlags::POSITION | StateFlags::MAXIMIZED).build();随后在 src-tauri/capabilities/default.json 中配置 capabilities,加入权限 window-state:allow-restore-state 与 window-state:allow-save-window-state。状态会在应用启动时自动恢复。

适用场景:需要在重启后保留窗口布局的桌面应用,以及涉及多显示器环境的窗口位置恢复。

限制与注意事项:需谨慎选择 StateFlags;在多显示器场景下,若显示布局发生变化,已保存的位置可能落到屏幕之外,需要处理此类边界情况。官方参考见 https://v2.tauri.app/plugin/window-state/。