Merge remote-tracking branch 'origin/v2' into feat/disable-window-buttons

.changes/window-is-focused.md

@@ -0,0 +1,6 @@
+---
+"window": "minor:feat"
+"window-js": "minor:feat"
+---
+
+Add `WebviewWindow.is_focused` and `WebviewWindow.getFocusedWindow` getters.

plugins/app/README.md

@@ -1,4 +1,4 @@
-# App
+![plugin-app](banner.png)
 
 This plugin provides APIs to read application metadata and macOS app visibility functions.
 

plugins/cli/README.md

@@ -1,4 +1,4 @@
-# CLI
+![plugin-cli](banner.png)
 
 Parse arguments from your Command Line Interface.
 

plugins/clipboard-manager/README.md

@@ -1,4 +1,4 @@
-# Clipboard Manager
+![plugin-clipboard-manager](banner.png)
 
 Read and write to the system clipboard.
 

plugins/dialog/README.md

@@ -1,4 +1,4 @@
-# Dialog
+![plugin-dialog](banner.png)
 
 Native system dialogs for opening and saving files along with message dialogs.
 

plugins/fs/README.md

@@ -1,4 +1,4 @@
-# File System
+![plugin-fs](banner.png)
 
 Access the file system.
 

plugins/global-shortcut/README.md

@@ -1,4 +1,4 @@
-# Global Shortcut
+![plugin-global-shortcut](banner.png)
 
 Register global shortcuts.
 

plugins/http/README.md

@@ -1,4 +1,4 @@
-# HTTP
+![plugin-http](banner.png)
 
 Access the HTTP client written in Rust.
 

plugins/notification/README.md

@@ -1,4 +1,4 @@
-# Notification
+![plugin-notification](banner.png)
 
 Send message notifications (brief auto-expiring OS window element) to your user. Can also be used with the Notification Web API.
 

plugins/os/README.md

@@ -1,4 +1,4 @@
-# Operating System
+![plugin-os](banner.png)
 
 Read information about the operating system.
 

plugins/process/README.md

@@ -1,4 +1,4 @@
-# Process
+![plugin-process](banner.png)
 
 This plugin provides APIs to access the current process. To spawn child processes, see the [`shell`](https://github.com/tauri-apps/tauri-plugin-shell) plugin.
 

plugins/shell/README.md

@@ -1,4 +1,4 @@
-# Shell
+![plugin-shell](banner.png)
 
 Access the system shell. Allows you to spawn child processes and manage files and URLs using their default application.
 

plugins/updater/README.md

@@ -1,4 +1,4 @@
-# Updater
+![plugin-updater](banner.png)
 
 In-app updates for Tauri applications.
 

plugins/window/README.md

@@ -1,4 +1,4 @@
-# Window
+![plugin-window](banner.png)
 
 Interact with the Tauri window.
 

plugins/window/guest-js/index.ts

@@ -563,6 +563,24 @@ class WindowManager extends WebviewWindowHandle {
     });
   }
 
+  /**
+   * Gets the window's current focus state.
+   * @example
+   * ```typescript
+   * import { appWindow } from '@tauri-apps/plugin-window';
+   * const focused = await appWindow.isFocused();
+   * ```
+   *
+   * @returns Whether the window is focused or not.
+   *
+   * @since 2.0.0
+   * */
+  async isFocused(): Promise<boolean> {
+    return window.__TAURI_INVOKE__("plugin:window|is_focused", {
+      label: this.label,
+    });
+  }
+
   /**
    * Gets the window's current decorated state.
    * @example
@@ -1914,6 +1932,27 @@ class WebviewWindow extends WindowManager {
     }
     return null;
   }
+
+  /**
+   *  Gets the focused window.
+   * @example
+   * ```typescript
+   * import { WebviewWindow } from '@tauri-apps/plugin-window';
+   * const focusedWindow = WebviewWindow.getFocusedWindow();
+   * ```
+   *
+   * @returns The WebviewWindow instance to communicate with the webview or `undefined` if there is not any focused window.
+   *
+   * @since 1.4
+   */
+  static async getFocusedWindow(): Promise<WebviewWindow | null> {
+    for (const w of getAll()) {
+      if (await w.isFocused()) {
+        return w;
+      }
+    }
+    return null;
+  }
 }
 
 /** The WebviewWindow for the current window. */

plugins/window/src/desktop_commands.rs

@@ -112,6 +112,7 @@ getter!(outer_size, PhysicalSize<u32>);
 getter!(is_fullscreen, bool);
 getter!(is_minimized, bool);
 getter!(is_maximized, bool);
+getter!(is_focused, bool);
 getter!(is_decorated, bool);
 getter!(is_resizable, bool);
 getter!(is_maximizable, bool);

plugins/window/src/lib.rs

@@ -40,6 +40,7 @@ pub fn init<R: Runtime>() -> TauriPlugin<R> {
                         desktop_commands::is_fullscreen,
                         desktop_commands::is_minimized,
                         desktop_commands::is_maximized,
+                        desktop_commands::is_focused,
                         desktop_commands::is_decorated,
                         desktop_commands::is_resizable,
                         desktop_commands::is_maximizable,