feat(core): add skip_taskbar API to the WindowBuilder/WindowOptions

Author: lucasfernog

.changes/api-skip-taskbar.md

@@ -0,0 +1,5 @@
+---
+"api": patch
+---
+
+Adds `skipTaskbar?: boolean` to the WindowOptions interface.

.changes/skip-taskbar.md

@@ -0,0 +1,7 @@
+---
+"tauri": patch
+"tauri-runtime": patch
+"tauri-runtime-wry": patch
+---
+
+Adds `skip_taskbar` API to the WindowBuilder.

core/tauri-runtime-wry/src/lib.rs

@@ -248,7 +248,8 @@ impl WindowBuilder for WindowBuilderWrapper {
       .maximized(config.maximized)
       .fullscreen(config.fullscreen)
       .transparent(config.transparent)
-      .always_on_top(config.always_on_top);
+      .always_on_top(config.always_on_top)
+      .skip_taskbar(config.skip_taskbar);
 
     if let (Some(min_width), Some(min_height)) = (config.min_width, config.min_height) {
       window = window.min_inner_size(min_width, min_height);
@@ -260,6 +261,10 @@ impl WindowBuilder for WindowBuilderWrapper {
       window = window.position(x, y);
     }
 
+    if config.focus {
+      window = window.focus();
+    }
+
     window
   }
 
@@ -355,6 +360,10 @@ impl WindowBuilder for WindowBuilderWrapper {
     ))
   }
 
+  fn skip_taskbar(self, skip: bool) -> Self {
+    Self(self.0.with_skip_taskbar(skip))
+  }
+
   fn has_icon(&self) -> bool {
     self.0.window.window_icon.is_some()
   }

core/tauri-runtime/src/webview.rs

@@ -146,6 +146,9 @@ pub trait WindowBuilder: WindowBuilderBase {
   /// Sets the window icon.
   fn icon(self, icon: Icon) -> crate::Result<Self>;
 
+  /// Sets whether or not the window icon should be added to the taskbar.
+  fn skip_taskbar(self, skip: bool) -> Self;
+
   /// Sets a parent to the window to be created.
   ///
   /// A child window has the WS_CHILD style and is confined to the client area of its parent window.

core/tauri-utils/src/config.rs

@@ -87,6 +87,9 @@ pub struct WindowConfig {
   /// Whether the window should always be on top of other windows.
   #[serde(default)]
   pub always_on_top: bool,
+  /// Whether or not the window icon should be added to the taskbar.
+  #[serde(default)]
+  pub skip_taskbar: bool,
 }
 
 fn default_window_label() -> String {
@@ -139,6 +142,7 @@ impl Default for WindowConfig {
       visible: default_visible(),
       decorations: default_decorations(),
       always_on_top: false,
+      skip_taskbar: false,
     }
   }
 }
@@ -640,6 +644,7 @@ mod build {
       let visible = self.visible;
       let decorations = self.decorations;
       let always_on_top = self.always_on_top;
+      let skip_taskbar = self.skip_taskbar;
 
       literal_struct!(
         tokens,
@@ -662,7 +667,8 @@ mod build {
         maximized,
         visible,
         decorations,
-        always_on_top
+        always_on_top,
+        skip_taskbar
       );
     }
   }
@@ -911,6 +917,7 @@ mod test {
         visible: true,
         decorations: true,
         always_on_top: false,
+        skip_taskbar: false,
       }],
       bundle: BundleConfig {
         identifier: String::from(""),

examples/api/src-tauri/src/main.rs

@@ -41,27 +41,23 @@ fn main() {
       SystemTrayMenuItem::Custom(CustomMenuItem::new("toggle".into(), "Toggle")),
       SystemTrayMenuItem::Custom(CustomMenuItem::new("new".into(), "New window")),
     ])
-    .on_system_tray_event(|app, event| {
-      match event.menu_item_id().as_str() {
-        "toggle" => {
-          let window = app.get_window("main").unwrap();
-          if window.is_visible().unwrap() {
-            window.hide().unwrap();
-          } else {
-            window.show().unwrap();
-          }
+    .on_system_tray_event(|app, event| match event.menu_item_id().as_str() {
+      "toggle" => {
+        let window = app.get_window("main").unwrap();
+        if window.is_visible().unwrap() {
+          window.hide().unwrap();
+        } else {
+          window.show().unwrap();
         }
-        "new" => app
-          .create_window(
-            "new".into(),
-            WindowUrl::App("index.html".into()),
-            |window_builder, webview_attributes| {
-              (window_builder.title("Tauri"), webview_attributes)
-            },
-          )
-          .unwrap(),
-        _ => {}
       }
+      "new" => app
+        .create_window(
+          "new".into(),
+          WindowUrl::App("index.html".into()),
+          |window_builder, webview_attributes| (window_builder.title("Tauri"), webview_attributes),
+        )
+        .unwrap(),
+      _ => {}
     })
     .invoke_handler(tauri::generate_handler![
       cmd::log_operation,

tooling/api/src/window.ts

@@ -803,6 +803,8 @@ interface WindowOptions {
   decorations?: boolean
   /** Whether the window should always be on top of other windows or not. */
   alwaysOnTop?: boolean
+  /** Whether or not the window icon should be added to the taskbar. */
+  skipTaskbar?: boolean
 }
 
 /**